wenjunduan PACE — Router & State Machine (v9.8.0)
6 路径
主 agent 收到用户输入后, 按改动量 + 紧急度判定路径:
| 路径 | 触发 | stage 流程 | 强制 review? | 强制 polish? | 强制 worktree? |
|---|---|---|---|---|---|
| Hotfix | 生产事故, 几分钟修 | impl → ship | ❌ | ❌ | ❌ |
| Bugfix | 已知 bug, 单文件 | report → (analyze) → impl → review → ship | ✅ 单维 | ❌ | ❌ (fix-note 必写) |
| Quick | 小改动, ≤3 文件 | plan → impl → review → ship | ✅ 单维 | ❌ | ❌ |
| Feature | 新功能, 单模块 | plan → impl → [runtime-verify?] → review → ship | ✅ 单维 | ❌ | ❌ (可选) |
| Refactor | 改架构, ≥5 文件 | plan → impl → runtime-verify → review → polish → ship | ✅ 三维度 | ✅ | ✅ 强制 |
| System | 跨模块, 系统级 | plan → design → impl → runtime-verify → review → polish → ship | ✅ 三维度 | ✅ | ✅ 强制 |
9 Stage 状态机
(大需求或描述模糊时)
↓
[brainstorm] ──→ [roadmap] ──→ plan ──→ [design] ──→ impl ──→ [runtime-verify] ──→ review ──→ [polish] ──→ ship
↑ (System) (3 维度) (Refactor/System)
ultrathink + critic 多轮
路由判断 (在 athena-dev 入口)
def route(user_input, ai_state):
# 1. 显式信号
if explicit_kws(["想法不清楚", "先 brainstorm", "讨论"]):
return "brainstorm"
if explicit_kws(["路线图", "分步推进", "拆分"]):
return "roadmap"
if explicit_kws(["bug", "修复"]):
return "Bugfix"
if explicit_kws(["重构", "refactor"]):
return "Refactor"
# 2. 隐式: 单词级模糊 → brainstorm (铁律[分诊])
if len(user_input.split()) < 8 and not has_concrete_verb(user_input):
return "brainstorm"
# 3. ≥ 3 模块需求 → roadmap (铁律[分诊])
if mentions_modules(user_input) >= 3:
return "roadmap"
# 4. 默认: 按改动量分 Feature/Quick/Hotfix
return classify_by_scope(user_input)
写入路由 (铁律[零写入] 红黄绿区)
| 区 | 条件 | 执行者 |
|---|---|---|
| 绿 | 单文件 ≤30 行无跨模块影响, 或 Hotfix/Quick | 主 agent 直接做 |
| 黄 | 单模块 Feature/Bugfix | Task subagent, worktree 可选 |
| 红 | Refactor/System 或并行 ≥2 写者 | subagent + isolation: worktree 强制 |
References (按需 Read, 不要预加载)
| 场景 | Read |
|---|---|
| 进入某 stage 前看详细工作流 / 数据目录 | references/stages.md |
| 选编排机制 (subagent / ultracode / /goal / Agent Team) | references/orchestration.md |
| 查 hook 联动 / compound 联动 / 项目级例外 | references/hooks.md |
最小循环提醒
- plan/design: 第一条 message 加 "ultrathink"; critic 多轮 (max =
_index.plan_critique_max_rounds) - impl: 按红黄绿区路由写入; PostToolUse hook 自动写 evidence.yaml
- runtime-verify (Refactor/System 强制 · Feature 可选): /athena-runtime-verify 用
/goal实跑 + 自测自改, 产出 runtime-verify.md (delivery-gate 验) - review: 并行 reviewer + spec-compliance, 后跑 evaluator → VERDICT 写
_index.next_action - ship: delivery-gate 强制门禁 (cleanup-pass / architecture / re-review / spec-compliance)