# Architect Planner

> 架构规划专家 - 使用 Codex 本地上下文、仓库证据和只读 child agent 进行大型系统架构设计与规划。

- Skill: `materialofair/architect-planner` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add materialofair/architect-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/materialofair/architect-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: materialofair (https://skillmd.com/u/materialofair)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/materialofair/architect-planner

---


# Architect Planner - Codex 原生架构规划

## 核心功能

面向复杂系统设计、架构评审和迁移规划。默认使用 Codex 当前会话、仓库检索、项目文档和只读 child agent；不调用外部模型 CLI。

## 触发场景

- "架构设计"
- "系统规划"
- "架构评审"
- "技术架构方案"
- "planner"

手动触发：

```text
使用 architect-planner 设计：<架构需求>
```

## Workflow

### Step 1: 收集输入

明确以下信息：

- 业务目标和成功标准
- 非功能需求：性能、可用性、数据规模、安全、合规
- 约束：团队、时间、预算、技术栈、迁移窗口
- 当前系统事实：入口、模块边界、依赖、部署方式

优先读取本地证据：

```bash
rg --files
rg -n "architecture|deploy|service|database|queue|auth|cache" README.md docs . 2>/dev/null
```

### Step 2: 项目事实扫描

如在代码仓内，先用本地 ProjectMind 或直接检索建立事实基础：

```bash
PROJECT_PATH="$(pwd)"
PROJECTMIND_HOME="${PROJECTMIND_HOME:-/Users/WangQiao/claude-enhanced-quality}"
PYTHON_BIN="${PYTHON_BIN:-$(command -v python3 || command -v python || true)}"
if [ -z "$PYTHON_BIN" ]; then
  echo "ProjectMind error: no python3 or python interpreter found" >&2
  exit 1
fi
"$PYTHON_BIN" "$PROJECTMIND_HOME/project_mind.py" "$PROJECT_PATH"
```

补充读取：

- `README.md`
- `docs/`
- package/build/deploy 配置
- 关键入口文件和模块边界

### Step 3: 派发架构探索代理

复杂场景使用 `explorer` 做只读架构调研：

```text
spawn_agent(agent_type="explorer", message="<architecture exploration prompt>")
wait_agent
close_agent
```

Prompt 框架：

```text
Your task is architecture exploration. Read-only.

<agent-instructions>
Inputs:
- Goal: <架构目标>
- Constraints: <约束>
- Known files/docs: <本地证据>

Trace the current architecture and produce:
1. Current system map
2. Critical dependencies and coupling points
3. Architecture risks
4. Candidate target architectures
5. Migration constraints and unknowns

Cite concrete files and configuration paths.
</agent-instructions>
```

### Step 4: 设计方案

至少给出：

- 推荐架构
- 备选方案和取舍
- 模块边界与数据流
- 技术选型理由
- 迁移步骤
- 风险与回滚策略
- 验证计划

### Step 5: 复核

高风险架构变更派发 `reviewer`：

```text
spawn_agent(agent_type="reviewer", message="<review architecture plan for risks>")
```

要求 reviewer 从正确性、安全、运维、迁移风险和测试缺口角度给 findings。

## 输出格式

```markdown
## Architecture Plan

### Context
[事实、约束、目标]

### Current State
[基于本地证据的现状]

### Recommendation
[推荐方案]

### Alternatives
| Option | Pros | Cons | When to choose |

### Target Architecture
[组件、边界、数据流]

### Migration Plan
1. [step] -> verify: [check]

### Risks
[风险和缓解]

### Validation
[命令、测试、指标]
```

## Fallback

如果 child agent 不可用，在当前回复中用 `[EXPLORER]` / `[REVIEWER]` 块自演分析，但必须引用本地文件和命令结果。