Blueprint — 构建计划生成器。它把一句话目标转成任何编码智能体都能“冷启动”执行的逐步构建计划。
【用途】 适用于把大型功能拆成多个 PR 并理清依赖顺序、规划跨多个会话的重构或迁移、协调子智能体之间的并行工作流,以及任何一旦会话间上下文丢失就会导致返工的任务。不适用于单 PR 即可完成、少于 3 次工具调用,或用户明确表示“直接做”的任务。
【主要能力】 Blueprint 运行 5 阶段流水线:
- Research:执行预检(git、gh 认证、远程、默认分支),随后读取项目结构、既有计划和记忆文件以收集上下文。
- Design:将目标拆成一个个“单 PR 大小”的步骤(通常 3–12 个),为每步分配依赖边、并行/串行顺序、模型层级(最强模型与默认模型)以及回滚策略。
- Draft:把自包含的 Markdown 计划文件写入 plans/ 目录。每个步骤都包含上下文简报、任务清单、验证命令和退出标准,使全新的智能体无需阅读前序步骤即可执行任一步骤。
- Review:把对抗式评审委托给最强模型子智能体(例如 Opus),依据检查表和反模式目录进行评审,并在定稿前修复所有严重问题。
- Register:保存计划、更新记忆索引,并向用户展示步骤数与并行情况摘要。
Blueprint 会自动检测 git/gh 是否可用。在具备 git + GitHub CLI 时,它生成完整的分支/PR/CI 工作流计划;不具备时切换为直接模式(原地编辑,不使用分支)。
【关键特性】
- 冷启动执行:每个步骤都包含自包含的上下文简报,无需先前上下文。
- 对抗式评审关卡:每份计划都由最强模型子智能体按检查表评审,覆盖完整性、依赖正确性和反模式检测。
- 分支/PR/CI 工作流:内建于每个步骤;在缺少 git/gh 时优雅降级为直接模式。
- 并行步骤检测:依赖图识别出不共享文件或输出依赖的步骤。
- 计划变更协议:步骤可按正式协议拆分、插入、跳过、重排或放弃,并保留审计轨迹。
- 零运行风险:纯 Markdown 技能。整个仓库只包含 .md 文件——没有钩子、没有 shell 脚本、没有可执行代码、没有 package.json、没有构建步骤。安装或调用时除 Claude Code 原生 Markdown 技能加载器外不运行任何东西。
【使用方式】 基本用法: /blueprint myapp "migrate database to PostgreSQL" 会生成 plans/myapp-migrate-database-to-postgresql.md,其中包含诸如以下步骤: Step 1:添加 PostgreSQL 驱动与连接配置 Step 2:为每张表创建迁移脚本 Step 3:更新仓储层以使用新驱动 Step 4:添加针对 PostgreSQL 的集成测试 Step 5:移除旧的数据库代码与配置
多智能体项目: /blueprint chatbot "extract LLM providers into a plugin system" 会生成包含尽可能并行步骤的计划(例如在插件接口步骤完成后,“实现 Anthropic 插件”和“实现 OpenAI 插件”并行执行)、模型层级分配(接口设计步骤用最强模型,实现用默认模型),以及每一步之后都要校验的不变量(例如“所有现有测试通过”“核心中不导入任何 provider”)。
【安装】 此技能随 ECC 提供。安装 ECC 时无需单独安装。 完整 ECC 安装:若你在 ECC 仓库检出中工作,可用以下命令确认技能存在: test -f skills/blueprint/SKILL.md 后续更新时,先审阅 ECC 差异再更新: cd /path/to/ECC git fetch origin main git log --oneline HEAD..origin/main # review new commits before updating git checkout <reviewed-full-sha> # pin to a specific reviewed commit
独立内置式安装:若你只把此技能内置于完整 ECC 安装之外,请从 ECC 仓库把已审阅的文件复制到 ~/.claude/skills/blueprint/SKILL.md。内置副本没有 git 远程,因此应从已审阅的 ECC 提交重新复制文件来更新,而不是运行 git pull。
【要求】
- Claude Code(用于 /blueprint 斜杠命令)
- Git + GitHub CLI(可选——启用完整分支/PR/CI 工作流;Blueprint 检测到缺失后自动切换到直接模式)
【来源说明】灵感来自 antbotlab/blueprint——上游项目与参考设计。