mcpField
R
recipe-plan

recipe-plan

github.com/shinpr开发70540 次安装6 天前更新
代码仓库

关于 recipe-plan

recipe-plan 是用于协调规划阶段的技能,负责选择设计文档、生成测试骨架,并安排工作计划的创建与审查。它面向准备进入实施阶段的团队,以工作计划审批作为授权执行的交接点。

主要功能

  1. 01选择设计文档
  2. 02生成验收测试骨架
  3. 03委托专门 Agent 创建工作计划
  4. 04安排工作计划审查与修正
  5. 05实施授权前进行审批

适用场景

  1. 01根据已批准的设计准备实施计划
  2. 02从设计文档生成测试骨架
  3. 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。

执行协议:

  1. 调用指定专家制作交付物 — 在专家之间传递数据并验证其结果
  2. 严格遵循 subagents-orchestration-guide Skill 的规划流程:
    • 执行下方定义的步骤
    • 停止并获取对计划内容的批准后再完成
  3. 范围:见下方的范围边界

在下方每次调用 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: create
  • designDoc: [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、适用依据和证据。

评论

支持 Markdown