Blueprint — 构建计划生成器 是做什么的?
将一句话目标转化为分步构建计划,任何编码代理均可无上下文直接执行。
何时使用
- 将大型功能拆分为多个具有明确依赖顺序的 PR
- 规划跨越多个会话的重构或迁移
- 在子代理间协调并行工作流
- 任何会话间上下文丢失可能导致返工的任务
不要使用 于可在单个 PR 内完成、少于 3 次工具调用的任务,或当用户说“直接做吧”时。
工作原理
Blueprint 运行一个五阶段管道:
- 研究 — 预检检查(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 插件”在插件接口步骤完成后并行运行)、模型层级分配(接口设计步骤使用最强模型,实现步骤使用默认模型),以及每一步后验证的不变量(例如,“所有现有测试通过”、“核心中无提供者导入”)。
关键特性
- 冷启动执行 — 每个步骤包含自包含的上下文摘要。无需前期上下文。
- 对抗性审查门 — 每个计划由最强模型子代理针对包含完整性、依赖正确性和反模式检测的检查清单进行审查。
- 分支/PR/CI 工作流 — 内置于每个步骤中。当 git/gh 不可用时优雅降级到直接模式。
- 并行步骤检测 — 依赖图识别没有共享文件或输出依赖的步骤。
- 计划变异协议 — 步骤可以拆分、插入、跳过、重新排序或放弃,附带正式协议和审计追踪。
- 零运行时风险 — 纯 Markdown 技能。整个仓库仅包含
.md文件——无钩子、无 shell 脚本、无可执行代码、无package.json、无构建步骤。安装或调用时除了 Claude Code 的原生 Markdown 技能加载器外没有任何内容运行。
安装
此技能随 Everything Claude Code 一起提供。安装 ECC 后无需单独安装。
完整 ECC 安装
如果您在 ECC 仓库检出版本中工作,请使用以下命令验证技能存在:
test -f skills/blueprint/SKILL.md
稍后更新时,在更新前查看 ECC 差异:
cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main # 审查新提交后再更新
git checkout <reviewed-full-sha> # 固定到特定审查后的提交
供应商独立安装
如果您仅在完整 ECC 安装之外引入此技能,请将审查后的文件从 ECC 仓库复制到 ~/.claude/skills/blueprint/SKILL.md。独立副本没有 git 远程仓库,因此应通过从审查后的 ECC 提交重新复制文件来更新,而不是运行 git pull。
要求
- Claude Code(用于
/blueprint斜杠命令) - Git + GitHub CLI(可选——启用完整的分支/PR/CI 工作流;Blueprint 检测缺失并自动切换到直接模式)
来源
灵感来自 antbotlab/blueprint——上游项目及参考设计。