用途:recipe-plan 专注于规划阶段,从设计文档生成工作计划(work plan),可选地先生成集成/E2E 测试骨架,并最终取得用户对计划内容的批准。
主要能力与流程:
- 设计文档选择:检查 docs/design/ 下是否存在设计文档,若无则通知用户;若有多份则列出供选择(可用 $ARGUMENTS 指定)。
- 测试骨架生成确认:询问用户是否先生成集成与 E2E 测试骨架。若用户需要,则生成 acceptance-test-generator 子代理,提示为“Generate test skeletons from Design Doc at [design-doc-path]”。若某条 lane 未生成 E2E 文件,需将明确的 lane 特定 e2eAbsenceReason 作为有效规划输入传递。
- 工作计划创建:生成 work-planner 子代理,提示为“Create work plan from design document at [design-doc-path]. …”,并在计划头部包含 Implementation Readiness: pending。
- 计划评审:生成 document-reviewer 子代理,doc_type: WorkPlan,target: docs/plans/[plan-name].md,mode: composite,评审内容涵盖与设计文档的语义可追溯性、Reference Contract Values 保真、早期验证放置、真实边界验证覆盖、Proof Strategy、Failure Mode Checklist、Review Scope 与 Quality Assurance 覆盖。评审结论分支:approved 则让 work-planner 更新一次,记录 Status: approved 与 Conditions: none;approved_with_conditions 或 needs_revision 则带发现/条件更新后重跑评审,最多 2 轮修订;rejected 则停止并向用户呈现阻塞性发现。
- 计划批准:将评审后的计划提交用户批量批准;用户要求修改则更新计划并重跑评审。
使用方式与限制:本技能充当编排者,所有工作通过 spawn_agent 调用子代理完成,spawn 规则为 fork_turns="none",使子代理只收到任务消息与显式提供的上下文。执行前需加载相关技能:documentation-criteria、implementation-approach、subagents-orchestration-guide、llm-friendly-context。用户要求生成测试时,必须先产生 acceptance-test-generator,否则工作规划不完整。流程中存在阻塞点,必须获得用户明确确认才能继续。技能在计划获批后结束,不包含实现。
完成标准:设计文档已选定;测试骨架生成已与用户确认(如需则已生成);工作计划已创建并评审;计划内容获用户批准;所有停止点均遵守用户确认。完成时输出:Planning phase completed. - Work plan: docs/plans/[plan-name].md - Status: Approved,并提示实现需另行指示。