blueprint

Blueprint — 构建计划生成器

将一行目标转化为逐步构建计划，任何编码智能体无需前置知识即可执行。

使用时机

• 将大型功能拆分为多个PR，并明确依赖顺序
• 规划跨多个会话的重构或迁移
• 协调子智能体之间的并行工作流
• 任何会话间上下文丢失会导致返工的任务

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

工作原理

Blueprint 运行一个5阶段流水线：

1. 研究 — 预检（git、gh认证、远程仓库、默认分支），然后读取项目结构、现有计划和记忆文件以收集上下文。
2. 设计 — 将目标分解为每个PR一个步骤（通常3-12步）。为每个步骤分配依赖边、并行/串行顺序、模型层级（最强vs默认）和回滚策略。
3. 草稿 — 将自包含的Markdown计划文件写入 plans/。每个步骤包含上下文摘要、任务列表、验证命令和退出标准——因此新智能体无需阅读先前步骤即可执行任何步骤。
4. 审查 — 将对抗性审查委托给最强模型子智能体（例如Opus），依据检查清单和反模式目录进行审查。在最终确定前修复所有关键发现。
5. 注册 — 保存计划，更新记忆索引，并向用户展示步骤数和并行度摘要。

Blueprint 自动检测 git/gh 的可用性。使用 git + GitHub CLI 时，生成完整的分支/PR/CI工作流计划。没有它们时，切换到直接模式（原地编辑，无分支）。

示例

基本用法

/blueprint myapp "migrate database to PostgreSQL"

生成 plans/myapp-migrate-database-to-postgresql.md，包含如下步骤：

• 步骤1：添加PostgreSQL驱动和连接配置
• 步骤2：为每个表创建迁移脚本
• 步骤3：更新仓库层以使用新驱动
• 步骤4：添加针对PostgreSQL的集成测试
• 步骤5：移除旧数据库代码和配置

多智能体项目

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

生成一个计划，其中尽可能包含并行步骤（例如，“实现Anthropic插件”和“实现OpenAI插件”在插件接口步骤完成后并行运行），模型层级分配（接口设计步骤使用最强模型，实现步骤使用默认模型），以及每个步骤后验证的不变条件（例如，“所有现有测试通过”，“核心中无provider导入”）。

主要特性

• 冷启动执行 — 每个步骤包含自包含的上下文摘要。无需前置上下文。
• 对抗性审查关卡 — 每个计划由最强模型子智能体根据检查清单进行审查，涵盖完整性、依赖正确性和反模式检测。
• 分支/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 —— 上游项目和参考设计。