用途:把设计文档转化为基于 TDD(测试驱动开发)的实施计划,产出粒度细、可并行执行的任务,并通过显式可追溯性确保设计规范被完整覆盖。
触发方式:运行 /exarchos:plan 命令;用户要求把设计拆解为任务;设计文档已完成需要实施步骤;用户说“plan the implementation”或类似表述;由 /exarchos:ideate 在设计完成后自动接续;由 plan-review 带 --revise 标记在发现缺口时自动接续。
主要能力:先分析设计文档,提取问题陈述、选定方案、技术设计、集成点、测试策略与开放问题;生成可追溯性矩阵,将设计章节映射到计划任务;把工作拆解为 2-5 分钟粒度的任务,每个任务先写失败测试、说明预期失败原因,再写最小实现;为任务指定 testingStrategy,并自动判定 propertyTests 与 benchmarks 标记;做依赖分析,识别顺序链与可并行组;生成计划文档到 docs/plans/YYYY-MM-DD-<feature>.md。
核心约束(铁律):没有先失败的测试,就不写生产代码。实现后需用 exarchos_orchestrate({ action: "check_tdd_compliance", featureId, taskId, branch }) 校验 git 历史中测试是否先于或伴随实现提交。计划完成后需依次运行 check_plan_coverage、check_provenance_chain(阻塞性,缺口必须先解决)、check_task_decomposition(顾问性,不阻塞审批)、spec_coverage_check、check_coverage_thresholds(默认行 80、分支 70、函数 100)。
修订模式:带 --revise 时读取 .planReview.gaps,重读设计并补任务,更新计划文件后清除缺口。修订循环上限 3 次,超过后设置 planReview.revisionsExhausted = true,提示“Plan revision failed after 3 attempts. Design may be incomplete.”,并建议 /exarchos:ideate --redesign。
状态与流程:保存计划时按 workflowType 切换阶段(feature → plan-review,refactor → overhaul-plan-review),通过 exarchos_workflow action: "set" 同时写入 artifacts.plan 与 tasks。plan → plan-review 转换需要 plan-artifact-exists 守卫。plan-review 发现缺口则回退到 /exarchos:plan --revise,无缺口则交由用户审批,审批后调用 /exarchos:delegate。
适用场景:已有设计文档、需要落地为可控可验证开发步骤的软件项目;尤其适合要求严格 TDD、需要并行任务编排与规范追溯的团队工作流。
限制:依赖 exarchos 工作流状态与 orchestrate 动作;设计文档需使用标准 Markdown 标题,否则 generate_traceability 可能失败;若设计未使用 DR-N 标识,provenance 检查会跳过。具体安装方式、收费、支持平台与效果数据暂未提供。