用途
blueprint 是一个提示工程技能,用于把明确需求写成 cooking 的 spec 与阶段任务,一次产出 spec.md 与 tasks/Pn.md,不改业务代码。仅当用户显式调用 blueprint,或由 rush 编排触发时使用。
主要能力
- 按 spec-template.md 写 spec.md,不增删标题,验收标准必须可判定,禁止「体验好」「尽量完善」等模糊表述。
- 按「阶段怎么切」与 task-template.md 写 tasks/Pn.md,不写 README.md 或其它索引文件。
- 处理「架构影响」:代码类对照 CODE-MAP.md 按 code-map-update.md「架构级变更」判定,算的逐条写,其余写 无;非代码写 无。
- 存在 .agents/docs/ACCEPTANCE.md 时,把完成标准逐条追加进 Pn.md「完成标准」,只验收单一阶段的给实现它的阶段,跨阶段的全局命令只给收口阶段,标「跳过」的照抄跳过标记。
- 运行 node .agents/scripts/cooking.mjs status <feature> 校验前置引用与成环,报错则改到通过。
- 支持增量补阶段:单位已有 tasks/ 时,为已通过阶段的回归或漏项追加一个新阶段,不重拆。
使用方式
- 前置检查:按 common.md 的「前置检查」节执行;已有单位先运行 node .agents/scripts/cooking.mjs status <feature>,goal.md 未确认则停止。
- 参数与命中规则见 common.md:命中标识处理该单位;标识后文本在无 tasks/ 时是需求描述,已有 tasks/ 时是回归/补漏描述,走增量补阶段;未命中且参数非空时,仅一段 kebab-case 当作新标识,否则整段是需求描述生成 slug 新开;参数为空时按 cooking 数量决定新开、使用或询问。
- 新开时只读其它 cooking 的 goal.md(没有则看 spec.md 标题)做冲突检查。
- 输入优先级:本次需求描述 > 已确认的 goal.md > 本对话已说清的需求,不扩大这些来源里没有的范围。
- 阶段切分:Pn 是阶段 id,不是串行序号;「前置任务」列出必须已实现完成且评审通过的 Pn,无则写 无;前置都通过的阶段可并行,但并行阶段改动范围必须互不重叠;每个阶段必须有实现改动,禁止纯校验阶段;跨阶段的全局验证挂到收口阶段;一个阶段要能在单个子代理上下文里做完。
- 增量补阶段:新建 tasks/P<n+1>.md(现有最大编号 +1),清单只含修复项与回归用例;ACCEPTANCE.md 追加规则同工作流;「前置任务」写被修复的阶段,依赖它且尚未评审通过的阶段也一并列入;不改 spec、不动既有 P*.md;运行 cooking.mjs status <feature> 校验。
- 结束汇报:spec 路径、「架构影响」(无,或条目原文)、阶段列表与依赖、status「可做」行里现在能开工的阶段;用户显式调用时,下一步只说 rush <feature>,不自动继续。
适用场景
- 用户显式调用 blueprint 时。
- 由 rush 编排触发时。
- 需要把明确需求转成可判定验收标准与阶段任务时。
- 已有 cooking 单位需要为已通过阶段追加回归或补漏阶段时。
限制
- 不改业务代码。
- 需求还写不成可判定的验收标准时:停止,建议先 explore,不要在本技能里开问答。
- explore 不是前置:没有 goal.md 也可以写。
- 增量补阶段时没有回归/补漏描述则停止,向调用方要,不要自己找回归;要改需求、重排既有阶段不走本节,需用户先 explore(会删掉 spec 与 tasks 重来)。
- 不写 README.md 或其它索引文件。
- goal.md 未确认时停止。