Blueprint — 构建计划生成器 是做什么的?
将一行目标转化为逐步执行的构建计划,任何编码代理都能直接执行。
何时使用
- 将大型功能拆分为多个拉取请求(PR),并明确依赖顺序
- 规划跨多个会话的重构或迁移
- 跨子代理协调并行工作流
- 任何因会话间上下文丢失而导致返工的任务
不要用于 可在单个 PR 内完成的任务、少于 3 次工具调用的任务,或用户说“直接做”的情况。
工作原理
Blueprint 运行一个五阶段管线:
- 研究 — 预检(git、gh 认证、远程仓库、默认分支),然后读取项目结构、现有计划和记忆文件以收集上下文。
- 设计 — 将目标分解为适合单个 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 仓库 checkout 中工作,请使用以下命令验证技能是否存在:
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> # 固定到特定的审查提交
独立 vendored 安装
如果你在完整 ECC 安装之外仅 vendoring 此技能,请将审查后的文件从 ECC 仓库复制到 ~/.claude/skills/blueprint/SKILL.md。Vendored 副本没有 git 远程仓库,因此请通过从审查过的 ECC 提交重新复制文件来更新,而不是运行 git pull。
要求
- Claude Code(用于
/blueprint斜杠命令) - Git + GitHub CLI(可选——启用完整的分支/PR/CI 工作流;Blueprint 会检测缺失并自动切换到直接模式)
来源
受 antbotlab/blueprint 启发——上游项目及参考设计。