Everything Claude Code Blueprint Skill 是一款面向 Claude Code、Codex、Cursor 等 AI 编程助手的工程计划自动生成器。它能将一句模糊目标自动拆解为多步、可并行、可追踪的工程蓝图，每一步都有自包含上下文说明，便于多 Agent 协作和多会话无缝衔接。适用于需求复杂、需多 PR 或多 Session 才能完成的开发任务，显著提升 AI 辅助编程的系统性和落地效率。

Everything Claude Code Blueprint Skill：将一行目标扩展为多会话多 Agent 工程计划的蓝图生成器

在 AI 编程助手日益普及的今天，开发者经常遇到这样的问题：一句看似简单的目标（如“把数据库迁移到 PostgreSQL”），实际却需要多个 PR、跨多次会话、甚至多位 Agent 协作才能顺利落地。传统做法往往靠人工拆解、手动记录依赖、上下文反复丢失，导致返工、遗漏和协作混乱。Everything Claude Code Blueprint Skill 正是为了解决这一痛点而设计的——它能自动将一行目标扩展为结构化、可追踪、可并行的多步工程蓝图，并内置多 Agent 协作和反模式审查机制。

本指南将详细介绍 Blueprint Skill 的适用场景、触发方式、完整使用流程、输出示例，以及与其他 Agent/Skill 的协作关系，帮助你在实际项目中高效用好这一核心能力。

Blueprint Skill 解决了什么问题？

不用 Blueprint Skill 的传统做法：

• 复杂需求靠人工拆解，容易遗漏关键步骤或依赖关系
• 多 PR/多会话任务上下文易丢失，Agent 难以无缝衔接
• 并行/串行任务分配混乱，协作效率低下
• 缺乏自动化审查，反模式和依赖错误难以及时发现

用 Blueprint Skill 后的优势：

• 一行目标自动拆解为 3~12 步，生成自包含 Markdown 计划
• 每一步都带有上下文说明、任务清单、验证命令和退出标准
• 自动识别依赖关系和可并行步骤，支持多 Agent 协作
• 内置最强模型的对抗式审查，确保计划完整性和防止反模式
• 支持 git/gh 检测，自动生成分支/PR/CI 流程，或降级为直接编辑模式
• 纯 Markdown 实现，无任何运行时风险，易于审计和版本管理

触发条件：什么时候该用 Blueprint Skill？

Blueprint Skill 适用于以下典型场景：

• 需要将大型功能拆分为多个 PR、有明确依赖顺序的任务
• 计划跨多次会话的重构、迁移或系统集成
• 需要多 Agent 或子 Agent 并行推进的复杂任务
• 任何上下文丢失会导致返工的场景

不要用在：只需单 PR 或 3 步以内即可完成的小任务，或用户明确要求“直接做，不用计划”的场合。

Step by Step：Blueprint Skill 实际使用流程

1. 触发 Blueprint Skill

你可以通过 Claude Code 的 /blueprint 命令或等效 Skill 调用方式触发。例如：

/blueprint myapp "migrate database to PostgreSQL"

这会为 myapp 项目生成迁移计划。

2. 5 阶段自动化蓝图生成

Blueprint Skill 内部自动执行以下 5 个阶段：

1. Research（调研）
   自动检测 git、gh CLI、远程分支等环境，读取项目结构、历史计划和记忆文件，收集上下文。
2. Design（设计）
   将目标拆解为 3~12 个“一 PR 一步”的子任务，自动分配依赖关系、串行/并行顺序、模型分级（如接口设计用最强模型，具体实现用默认模型）、每步回滚策略。
3. Draft（起草）
   生成 Markdown 计划文件（如 plans/myapp-migrate-database-to-postgresql.md），每一步都带有独立上下文说明、任务清单、验证命令和退出标准。
4. Review（审查）
   由最强模型子 Agent（如 Opus）对计划进行对抗式审查，检查完整性、依赖正确性和反模式，自动修正所有关键问题。
5. Register（注册）
   保存计划文件、更新记忆索引，并向用户汇报步骤数和并行化摘要。

3. 输出结果

你会在 plans/ 目录下看到自动生成的 Markdown 蓝图。例如：

plans/myapp-migrate-database-to-postgresql.md

内容结构大致如下：

示例片段

# myapp: Migrate Database to PostgreSQL

## Step 1: Add PostgreSQL driver and connection config
- Context: 当前使用 SQLite，需支持 PostgreSQL 配置
- Tasks:
  - 安装 PostgreSQL 驱动
  - 配置连接参数
- Verification:
  - `npm run db:connect:postgres`
- Exit Criteria:
  - 连接 PostgreSQL 成功，旧功能不受影响

## Step 2: Create migration scripts for each table
...

每一步都可被单独分配给子 Agent，即使 Agent 无前置上下文也能 cold-start 执行，极大提升多 Agent 协作效率。

4. 并行与依赖关系自动识别

Blueprint Skill 会自动分析哪些步骤可以并行（如“实现 Anthropic 插件”与“实现 OpenAI 插件”可在接口定义后并行），并在计划中明确标注依赖关系，便于多 Agent/多会话协作。

5. 对抗式审查与反模式防护

每份蓝图都会被最强模型子 Agent 逐项审查，涵盖：

• 步骤是否完整、依赖是否正确
• 是否有常见反模式（如遗漏回滚、遗漏测试）
• 计划是否能被冷启动 Agent 无缝衔接

所有关键问题会在输出前自动修正，确保计划质量。

6. 与其他 Agent/Skill 的协作

• 与 Planner Agent：Planner 适合复杂任务的多步计划，但 Blueprint Skill 更强调可并行、可协作和自包含上下文，适合多 Agent 场景。
• 与 GAN Planner Agent：GAN Planner 生成产品规格，Blueprint Skill 负责将规格落地为可执行蓝图，两者可串联使用。
• 与 Team Builder Skill：Blueprint 生成蓝图后，Team Builder 可自动为每一步分配合适的子 Agent 并并行推进。
• 与 Verification Loop Skill：每一步完成后自动触发验证循环，确保质量闭环。

更多 ECC 体系的 Agent/Skill 协作模式，可参考Everything Claude Code 完全指南。

Blueprint Skill 的输出示例

多 Agent 插件系统重构蓝图：

/blueprint chatbot "extract LLM providers into a plugin system"

生成的计划会包含：

• 步骤 1：设计插件接口（强模型，需审查）
• 步骤 2：实现 Anthropic 插件（可并行）
• 步骤 3：实现 OpenAI 插件（可并行）
• 步骤 4：集成插件系统到主流程
• 步骤 5：全量测试与回归验证
• 每步都明确依赖关系和验证标准

常见问题和注意事项

FAQ

Q: Blueprint Skill 和普通的 Planner/Task List 有什么区别？
A: Blueprint Skill 不仅自动拆解目标，还生成自包含上下文、依赖图、并行关系和对抗式审查，适合多 Agent/多会话协作，远超普通任务清单。

Q: 没有 git 或 GitHub CLI 也能用吗？
A: 可以。Blueprint Skill 会自动检测环境，若无 git/gh，则降级为直接编辑模式，仍可生成完整蓝图，只是不包含分支/PR/CI 流程。

Q: 如何更新 Blueprint Skill？
A: 若用 Everything Claude Code 官方仓库，随 ECC 更新自动获得新版；如单独引用，需手动复制 reviewed 版本到 ~/.claude/skills/blueprint/SKILL.md。

---

通过 Blueprint Skill，开发者可以把复杂目标一键转化为结构化、可协作、可审查的工程蓝图，极大提升 AI 编程助手的系统性落地能力。建议结合 Verification Loop Skill 等 ECC 组件，打造端到端的高效 AI 辅助开发流程。