用途:在实现之前先做规划,把模糊想法变成有质量门槛的工作计划,避免返工、范围蔓延和遗漏边界情况。适用场景包括“plan this”“plan the”“let's plan”、需求不清晰需要结构化收集、需要评审已有计划(--review)、需要多视角共识(--consensus 或 ralplan),以及任务宽泛需要先界定范围。
主要能力与模式:
- 访谈模式:宽泛请求默认触发,一次只问一个问题,先用 explore 代理收集代码库事实再向用户提问,可参考 Analyst 分析隐藏需求与风险。
- 直接模式:--direct 或请求已足够详细时跳过访谈,直接生成计划。
- 共识模式:--consensus 或“ralplan”,按 Planner → Architect → Critic 顺序循环直至达成一致,默认 RALPLAN-DR 精简模式;遇 --deliberate 或明确高风险信号(认证/安全、数据迁移、破坏性/不可逆变更、生产事故、合规/PII、公共 API 破坏)切换为审慎模式。加 --interactive 可在草案评审和最终批准步骤提示用户。
- 评审模式:--review 或“review this plan”,读取 .omc/plans/ 中的计划,由 Critic 给出 APPROVED、REVISE 或 REJECT 结论。
输出与质量:计划包含需求摘要、可测试的验收标准、带文件引用的实施步骤、风险与缓解、验证步骤;共识模式还包括 Principles、Decision Drivers、Options 的 RALPLAN-DR 摘要与 ADR 章节;审慎模式补充预演失败(3 个场景)和扩展测试计划(单元/集成/e2e/可观测性)。草案存 .omc/drafts/。质量要求:80% 以上论断引用文件/行,90% 以上标准可测试,风险均有缓解措施。
限制与注意:共识模式的代理调用必须串行,先等 Architect 再调 Critic;最多 5 轮迭代,未达成一致时把最佳版本交给用户;不用 --interactive 时只输出计划,不自动执行;用户批准后必须调用 Skill("oh-my-claudecode:ralph") 或 team 执行,规划代理内不直接改源码。用户说“just do it”或“skip planning”时应转 ralph 执行。原 /planner、/ralplan、/review 已合并进 /plan。安装命令本次资料未提供。