用途
recipe-plan 是 shinpr/claude-code-workflows 中专注于规划阶段的技能（recipe）。其目标是从设计文档（Design Doc）出发，生成工作计划（Work Plan），并在评审收敛后获得用户对计划的批准。技能本身定位为编排器（orchestrator），负责做出本 recipe 的工作流决策、在命名专家子代理之间传递数据并验证返回结果，而将语义性交付物的生产委托给指定的专家子代理。
主要能力
- 设计文档选择：优先使用 $ARGUMENTS 中显式提供的 Design Doc；否则在 docs/design/ 下恰好只有一个 Design Doc 时使用它；不存在时报告，存在多个时列出供选择。
- 测试骨架生成：调用 acceptance-test-generator，传入 design_docs 与 confirmed_requirement_context。当设计文档没有合理的集成/E2E 证明边界时，该生成器可能不选择任何 lane；有证据支持的空 lane 视为该 lane 完成并继续。
- 工作计划创建：通过 Agent 工具调用 work-planner（subagent_type: "dev-workflows:work-planner"，mode: create），传入 designDoc、prd（存在时）以及非空的 testSkeletons 路径。
- 工作计划评审：调用 document-reviewer（subagent_type: "dev-workflows:document-reviewer"）评审工作计划的实现范围、任务、完成标准、依赖、执行顺序、精确源锚点存在性、可执行验证和评审范围。
- 计划批准：将评审后的工作计划提交用户批量批准；用户要求修改时，原样重新调用 work-planner 并重跑评审步骤。
使用方式
技能按固定执行流程运行：
- 设计文档选择。
- 测试骨架生成：调用 acceptance-test-generator，遵循 subagents-orchestration-guide 的 HC-06 处理 value_input_required 及其未知值延续；将每个非空生成的骨架路径传给下一流程。
- 工作计划创建：调用 work-planner。
- 工作计划评审：调用 document-reviewer，并通过 Review Resolution Gate 完成修正复审、其父需求或权限退出以及收敛；仅在收敛条件满足时才提交计划批准。
- 提交批准：向用户展示评审后的工作计划；用户请求变更时，原样重新调用 work-planner 并重跑第 4 步。
在每次 Agent 调用时，提示词按机械提取方式构建：将命名源值复制到精确字段，仅应用声明的序列化，然后立即调用。
适用场景
适用于已有设计文档、需要进入实现前规划阶段的开发工作流：从设计文档生成测试骨架与工作计划，经文档评审后取得用户对计划的批准。技能在用户授权实现所评审的计划时完成，之后需另行提供实现指令。
限制与约束
- 用户必须显式指示并授权 recipe 中命名的每次子代理调用；仅在其前置条件满足时执行每个适用调用。
- 在编写 Agent 提示词、交接或生成产物前，需先执行 llm-friendly-context 技能；在做出工作流决策、调用代理或解决发现前，需先执行 subagents-orchestration-guide 技能。
- Review Resolution Gate 为强制门禁：每个可操作的交付物评审发现都必须通过 subagents-orchestration-guide 的 Review Resolution 解决后才能修正或推进；在首次发现处置前，需读取已加载 subagents-orchestration-guide 技能中的 references/review-resolution.md。
- 完成响应中，若工作计划评审期间有发现被拒绝，需追加其 ID、治理理由和证据。
- 仅当已确认结果、期望未来需求和非目标无法同时保持为真且必须由用户选择时，才返回需求门禁。
- 未解决的技术证据或外部依赖需连同受影响任务和验证边界记录在计划中。
完成响应
计划批准后，推荐输出标准块：
Planning phase completed.
- Work plan: docs/plans/[plan-name].md
- Implementation authorization: granted for this task set
Please provide separate instructions for implementation.