blueprint

name	blueprint
description	将单行目标转化为针对多会话、多代理工程项目的分步构建计划。每个步骤都包含自包含的上下文简报，以便新代理可以直接执行。包括对抗性审查门禁、依赖图、并行步骤检测、反面模式目录和计划变更协议。 触发条件：用户为复杂的跨 PR 任务请求计划、蓝图或路线图，或描述需要多个会话完成的工作。 不要触发：任务可以在单个 PR 中完成，或者工具调用次数少于 3 次，或者用户说“直接做”。
origin	community

蓝图 — 构建计划生成器 (Blueprint — Construction Plan Generator)

将单行目标转换为分步构建计划，使任何编程代理都能直接上手执行。

何时使用

• 将大型功能拆分为多个具有清晰依赖顺序的 PR
• 规划跨越多个会话的重构或迁移
• 协调子代理之间的并行工作流
• 任何会话间上下文丢失可能导致返工的任务

不要用于：可在单个 PR 中完成的任务、少于 3 次工具调用的任务，或当用户说“直接做”时。

工作原理

Blueprint 运行 5 阶段管道：

1. 研究 (Research) — 预检（git, gh auth, remote, 默认分支），然后读取项目结构、现有计划和记忆文件以收集上下文。
2. 设计 (Design) — 将目标拆分为 PR 规模的步骤（通常为 3-12 个）。为每个步骤分配依赖边、并行/串行顺序、模型层级（最强 vs 默认）以及回滚策略。
3. 起草 (Draft) — 在 plans/ 中编写一个自包含的 Markdown 计划文件。每个步骤都包含上下文简报、任务列表、验证命令和退出标准 —— 因此新代理无需阅读前面的步骤即可执行任何一步。
4. 审查 (Review) — 委托一个最强模型子代理（如 Opus）对照检查清单和反面模式目录进行对抗性审查。在最终确定前修复所有关键发现。
5. 注册 (Register) — 保存计划，更新记忆索引，并向用户展示步骤计数和并行性摘要。

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 安装

如果您是从 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 —— 上游项目和参考设计。