关于 recipe-plan
recipe-plan 是用于协调规划阶段的技能,负责选择设计文档、生成测试骨架,并安排工作计划的创建与审查。它面向准备进入实施阶段的团队,以工作计划审批作为授权执行的交接点。
主要功能
- 01选择设计文档
- 02生成验收测试骨架
- 03委托专门 Agent 创建工作计划
- 04安排工作计划审查与修正
- 05实施授权前进行审批
适用场景
- 01根据已批准的设计准备实施计划
- 02从设计文档生成测试骨架
- 03审查并批准工作计划
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ shinpr/ claude-code-workflows --skill recipe-plan安装后在 Claude Code 中输入/recipe-plan确认已加载。
详细介绍
用户明确指示:用户明确指示并授权执行此配方中列出的每次子 Agent 调用。满足前置条件时,执行所有适用的调用。
在编写 Agent 提示词、交接内容或生成的产物之前,执行 Skill:llm-friendly-context。 在作出工作流决策、调用 Agent 或处理审查意见之前,执行 Skill:subagents-orchestration-guide。
上下文:专用于规划阶段。
编排器定义
核心身份:“我是一个编排器。”(参见 subagents-orchestration-guide Skill)
本地权限门槛:作出本配方的工作流决策,并直接验证每项返回结果;将语义交付物的制作委派给指定的专家。
审查意见处理门槛[强制]:在更正或推进之前,必须通过 subagents-orchestration-guide 的 Review Resolution 处理所有可执行的交付物审查意见。
处理第一条审查意见之前,先阅读已加载的 subagents-orchestration-guide Skill 中的 references/review-resolution.md。
执行协议:
- 调用指定专家制作交付物 — 在专家之间传递数据并验证其结果
- 严格遵循 subagents-orchestration-guide Skill 的规划流程:
- 执行下方定义的步骤
- 停止并获取对计划内容的批准后再完成
- 范围:见下方的范围边界
在下方每次调用 Agent 时,均以机械方式提取内容来构建提示词:将指定的源值复制到对应字段,仅应用声明的序列化方式,然后立即调用。
Acceptance-test-generator 属于此规划流程;如果 Design Doc 没有合理的集成/端到端验证边界,它可能不会选择任何测试通道。
范围边界
此 Skill 包含:
- 选择 Design Doc
- 使用 acceptance-test-generator 生成测试框架
- 使用 work-planner 制定工作计划
- 使用 document-reviewer 审查工作计划
- 获取计划批准
职责边界:当用户授权实施已审查的计划时,此 Skill 即告完成。
遵循以下规划流程:
执行流程
第 1 步:选择 Design Doc
- 如果
$ARGUMENTS中明确提供了 Design Doc,则使用该文档 - 否则,如果
docs/design/下恰好有一份 Design Doc,则使用该文档 - 如果没有,则报告未找到;如果有多份,则列出以供选择
第 2 步:生成测试框架
- 调用 acceptance-test-generator,将
design_docs: [selected Design Doc path]作为参数,并将confirmed_requirement_context设为其 Requirement Convergence 部分指定的已批准 PRD 路径;如果不存在 PRD,则设为该部分未经更改的收敛记录 - 遵循 subagents-orchestration-guide HC-06 处理
value_input_required及其未知值的后续流程 - 将所有非空的生成框架路径传递给下一流程;对于有证据支持的空测试通道,视为该通道已完成,并继续下一流程
第 3 步:制定工作计划
使用 Agent 工具调用 work-planner:
subagent_type:"dev-workflows:work-planner"description:"制定工作计划"mode: createdesignDoc: [selected Design Doc path]- 存在已批准的 PRD 时,使用
prd: [approved PRD path] testSkeletons: [non-null generatedFiles paths]
步骤 4:工作计划审查
调用 document-reviewer 审查工作计划:
subagent_type: "dev-workflows:document-reviewer"description: "工作计划审查"prompt: "doc_type: WorkPlan target: docs/plans/[plan-name].md. Review the Work Plan's own Implementation Scope, tasks, Completion Criteria, dependencies, execution order, exact source-anchor existence, executable verification, and Review Scope. Governing Documents paths are citation sources only; keep issues limited to violations of cited obligations."- 通过修正后重新审查、其上级要求或权威退出以及收敛,执行审查问题解决关卡;对于重新指派的修正,使用更新模式下的 work-planner。仅在达到收敛条件后提交计划供审批。
步骤 5:提交审批
- 将审查后的工作计划提交给用户,供其批量审批。如果用户要求修改,则使用用户原话重新调用 work-planner,并重新执行步骤 4。
- 在计划中记录尚未解决的技术证据或外部依赖,以及其影响的任务和验证边界。只有在既定结果、期望的未来要求和非目标无法同时成立且必须由用户作出选择时,才返回需求关卡。
完成时的响应
建议:计划获批后,输出以下标准区块。
Planning phase completed.
- Work plan: docs/plans/[plan-name].md
- Implementation authorization: granted for this task set
Please provide separate instructions for implementation.
如果工作计划审查期间有问题未获采纳,请在此完成响应中附上其 ID、适用依据和证据。