Blueprint — 施工计划生成器
将单行目标转化为分步施工计划,任何编码代理都能冷启动执行。
何时使用
- 将大型功能拆分为多个具有明确依赖顺序的 PR
- 规划跨多个会话的重构或迁移
- 协调子代理间的并行工作流
- 任何因会话间上下文丢失而导致返工的任务
请勿用于 可在单个 PR 内完成、少于 3 次工具调用,或用户明确表示“直接做”的任务。
工作原理
Blueprint 运行一个 5 阶段流水线:
- 研究 — 预检(git、gh auth、远程仓库、默认分支),然后读取项目结构、现有计划和记忆文件以收集上下文。
- 设计 — 将目标分解为适合单次 PR 的步骤(通常 3–12 步)。为每个步骤分配依赖边、并行/串行顺序、模型层级(最强 vs 默认)和回滚策略。
- 草拟 — 将自包含的 Markdown 计划文件写入
plans/。每个步骤都包含上下文摘要、任务列表、验证命令和退出标准 — 这样新的代理无需阅读先前步骤即可执行任何步骤。 - 审查 — 委托最强模型子代理(例如 Opus)根据清单和反模式目录进行对抗性审查。在最终确定前修复所有关键发现。
- 注册 — 保存计划、更新内存索引,并向用户展示步骤计数和并行性摘要。
Blueprint 自动检测 git/gh 可用性。如果具备 git + GitHub CLI,它会生成完整的分支/PR/CI 工作流计划。如果没有,则切换到直接模式(原地编辑,无分支)。
示例
基本用法
/blueprint myapp "将数据库迁移到PostgreSQL"
生成 plans/myapp-migrate-database-to-postgresql.md,包含类似以下的步骤:
- 步骤 1:添加 PostgreSQL 驱动程序和连接配置
- 步骤 2:为每个表创建迁移脚本
- 步骤 3:更新仓库层以使用新驱动程序
- 步骤 4:添加针对 PostgreSQL 的集成测试
- 步骤 5:移除旧数据库代码和配置
多代理项目
/blueprint chatbot "将LLM提供商提取到插件系统中"
生成一个尽可能包含并行步骤的计划(例如,在插件接口步骤完成后,“实现 Anthropic 插件”和“实现 OpenAI 插件”可以并行运行),分配模型层级(接口设计步骤使用最强模型,实现步骤使用默认模型),并在每个步骤后验证不变量(例如“所有现有测试通过”、“核心模块无提供商导入”)。
主要特性
- 冷启动执行 — 每个步骤都包含自包含的上下文摘要。无需先前上下文。
- 对抗性审查门控 — 每个计划都由最强模型子代理根据清单…