
关于
蓝图技能,用于生成项目架构和代码结构的初始设计模板。
name: blueprint description: >- 将一行目标转化为多会话、多代理工程项目的分步构建计划。每个步骤都有 独立的上下文简报,使全新的代理可以冷启动执行。包含对抗性审查门控、 依赖图、并行步骤检测、反模式目录和计划变更协议。 触发条件:用户请求复杂多PR任务的计划、蓝图或路线图,或描述需要多个会话的工作。 不触发条件:任务可在单个PR或少于3次工具调用中完成,或用户说"直接做"。 origin: community
Blueprint — 构建计划生成器
将一行目标转化为任何编码代理都能冷启动执行的分步构建计划。
何时使用
- 将大型功能拆分为具有明确依赖顺序的多个PR
- 规划跨多个会话的重构或迁移
- 协调跨子代理的并行工作流
- 任何会话间上下文丢失会导致返工的任务
不要使用:任务可在单个PR中完成、少于3次工具调用、或用户说"直接做"时。
工作原理
Blueprint 运行5阶段流水线:
- 研究 — 预检查(git、gh auth、remote、default branch),然后读取项目结构、现有计划和记忆文件以收集上下文。
- 设计 — 将目标拆分为单PR大小的步骤(通常3-12个)。分配依赖边、并行/串行排序、模型层级(最强 vs 默认)和每步回滚策略。
- 草稿 — 将独立的Markdown计划文件写入
plans/。每个步骤包含上下文简报、任务列表、验证命令和退出标准——使全新代理无需阅读前序步骤即可执行任何步骤。 - 审查 — 将对抗性审查委托给最强模型子代理(如Opus),对照检查清单和反模式目录进行审查。在最终确定前修复所有关键发现。
- 注册 — 保存计划,更新记忆索引,并向用户展示步骤数量和并行性摘要。
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提交重新复制文件来更新。
兼容工具
Claude CodeCursor
标签
通用
