用途:该技能负责撰写统一 docs/specs/ 规格工件中的 ## Decomposition 部分,将设计拆解为细粒度、可并行化的任务,并保证每个任务显式追溯到同一文档 ## Design & Rationale 中的 DR-N 需求。所有可追溯性在单个文档内闭合,不产生第二个文件;文档结构由 references/spec-template.md 规定。
触发条件:用户运行 plan 命令;用户想把规格拆成任务;某统一规格的 Design & Rationale 部分需要拆解;用户说“plan the implementation”等类似表述;从 ideate 自动衔接(Design & Rationale 写完后);或从 plan-review 带 --revise 标志自动衔接。
主要能力与用法:
- 分析 Design & Rationale,提取问题陈述、所选方案、DR-N 需求、技术设计、集成点与待决问题。
- 使用 exarchos_orchestrate({ action: "generate_traceability", designFile, planFile, outputFile }) 预填追溯矩阵。
- 按 references/task-template.md 的 TDD 格式拆解任务,粒度约 2–5 分钟,一个测试对应一个行为,先基础类型接口、再核心行为、再边界与错误处理、最后集成胶水代码;为每个任务设定 testingStrategy 及 riskTier/boundaryTouching。
- 分析依赖,划分顺序链与可并行组(可在 worktree 中同时运行)。
- 将 ## Decomposition 写入 docs/specs/YYYY-MM-DD-<feature>.md。
- 规划校验:check_plan_coverage、check_provenance_chain(阻断性,须通过)、check_task_decomposition(咨询性)、spec_coverage_check(coveragePhase: "plan"),以及 check_coverage_thresholds。
验证阶梯:按风险等级决定验证深度——low 用静态分析(类型检查+lint);medium 用范围测试加 check_test_adequacy 杀伤探针;high 再加集成套件(及边界处的变异充分性)。测试顺序为结果导向,测试后补亦可。
修订模式:--revise 时读取 .planReview.gaps,重读设计、补任务、更新计划文件,再用 exarchos:exarchos_workflow action: "update" 清除 gaps;修订上限 3 次,超限则置 planReview.revisionsExhausted = true 并建议 ideate --redesign。
状态与流转:保存规格后记录 artifacts.plan 为统一规格路径,按 workflowType 流转(feature → plan-review,refactor → overhaul-plan-review);plan → plan-review 需 plan-artifact-exists 守卫。之后自动进入 plan-review 的对抗式只读复核,通过后由用户批准。旧的两文件拆分(docs/plans/)仅保留给已在进行中的旧工作流。
限制:以上流程、命令与行为均以资料为据;未提供的具体定价、平台支持等信息暂未提供。