3.2 KiB
3.2 KiB
RIPER-7 阶段编排 v9.2.0
每阶段进入前 (通用)
- 这一步要解决的核心问题是什么?
- 项目里有没有类似实现? → 搜索 (Grep/Glob, 或 augment-context-engine 如已安装)
- 用到的库 API 确定吗? → context7 skill 查文档
- .ai_state/lessons.md + conventions.md 有相关经验吗?
R₀ 需求精炼 (Path B+)
技能: brainstorm skill (含步骤0自主调研)
产出: .ai_state/design.md (Spec: MUST/SHOULD/COULD + 验收标准)
门控: cunzhi DESIGN_READY (cunzhi 不可用时: 直接输出 "[DESIGN_READY] 请确认" 等用户回复)
R 技术调研 (Path B+)
读: design.md 动手: 搜索相关代码 + 查库版本和 API 产出: design.md 追加技术方案 要回答: 有没有可复用的现有代码? 需要新依赖吗?
D 方案定稿 (Path B+)
读: design.md
检查: 接口最小化? 错误处理完整? 有没有更简单的方案?
产出: design.md 最终版 (含验收标准)
门控: cunzhi DESIGN_FINALIZED (cunzhi 不可用时: 直接输出确认提示)
P 计划 (Path B+)
技能: plan-first skill → 生成 plan.md (T-001/T-002... 格式) 双 Agent: 如果 Codex 可用 → codex-review skill 对抗审查
- CC 提交 plan.md → Codex 质疑 → CC 评估采纳/驳回 → 循环
- 终止: VERDICT: APPROVED / 连续2轮全驳 / 超5轮
- 审查结果持久化到 reviews/review-{uuid}.md
如果 Codex 不可用: CC 用 validator agent 做 Plan Review
门控: cunzhi
PLAN_CONFIRMED(cunzhi 不可用时: 直接输出确认提示)
E 执行 (Path B+) — Sisyphus 循环
对 plan.md 每个 Task:
- 读 Task 文本 + 相关文件 + conventions.md
- 双 Agent: 如果 Codex 可用 → codex-comm skill 委托 Codex 执行 如果 Codex 不可用 → CC builder agent 执行 2.5. Reflexion (自我反思 → reflexion skill): "这个实现有没有: 走捷径/忽略边界/硬编码/过度工程/偏离 spec?" 发现问题 → 立即修复 值得记录 → lessons.md
- Micro-review: 对标 design.md spec + conventions.md 标准 通过 → [x] Task + commit 不通过 → 反馈修复 铁律: plan.md 有任何 [ ] 未完成, 不停止。这就是 Sisyphus。
T 测试/审查 (Path B+)
- verification skill: 跑测试 + 覆盖率 1.5. 验收标准确认: 读 design.md "## 验收标准" → 逐条确认是否满足 未满足 → 标注到 quality.md "## 未满足验收标准"
- code-review skill: 代码审查
- 双 Agent 互审: 如果 Codex 可用 → CC 审查 Codex 产出 + Codex 反审 CC 修改 如果 Codex 不可用 → CC 单方审查
- 综合 → quality.md
- 4 级 Quality Gate (delivery-gate.cjs): PASS (exit 0) → 允许停止 CONCERNS (exit 0 + stdout 警告) → 允许停止, 警告注入 context REWORK (exit 2) → 阻断停止, 强制修复 FAIL (exit 2) → 阻断停止, 必须大幅修复
V 归档 (Path B+)
- kaizen skill: 回顾 + lessons.md 1.5. 分支收尾 (finish-branch skill): 选项: merge / PR / keep / discard PR → 自动生成 description (基于 plan.md + quality.md)
- cunzhi
DELIVERY_COMPLETE(cunzhi 不可用时: 直接输出确认提示)