Blueprint构建计划生成器：将目标转化为AI编码代理可执行的逐步开发计划

blueprint by affaan-m/everything-claude-code

568 周安装量

105,000 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/affaan-m/everything-claude-code --skill blueprint

AI/机器学习开发自动化

🇨🇳中文介绍

Blueprint — 构建计划生成器

将单行目标转化为逐步构建计划，任何编码代理都能直接执行。

使用场景

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

请勿用于可在单个 PR 内完成的任务、少于 3 次工具调用的任务，或当用户说"直接做吧"时。

工作原理

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

研究 — 飞行前检查（git、gh 认证、远程仓库、默认分支），然后读取项目结构、现有计划和记忆文件以收集上下文。
设计 — 将目标分解为适合单个 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，包含如下步骤：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

749,400 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

255,700 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

205,600 周安装

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

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

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

冷启动执行 — 每个步骤都包含自包含的上下文摘要。无需先前上下文。
对抗性审查门控 — 每个计划都由最强模型子代理根据涵盖完整性、依赖关系正确性和反模式检测的检查清单进行审查。
分支/PR/CI 工作流 — 内置于每个步骤中。当 git/gh 缺失时，优雅降级为直接模式。
并行步骤检测 — 依赖图识别没有共享文件或输出依赖关系的步骤。
计划变更协议 — 步骤可以通过正式的协议和审计跟踪进行拆分、插入、跳过、重新排序或放弃。
零运行时风险 — 纯 Markdown 技能。整个仓库仅包含 .md 文件——无钩子、无 shell 脚本、无可执行代码、无 package.json、无构建步骤。除了 Claude Code 原生的 Markdown 技能加载器外，安装或调用时不会运行任何东西。

此技能随 Everything Claude Code 一同提供。安装 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 安装之外仅独立安装此技能，请将已审查的文件从 ECC 仓库复制到 ~/.claude/skills/blueprint/SKILL.md。独立副本没有 git 远程仓库，因此通过从已审查的 ECC 提交中重新复制文件来更新它们，而不是运行 git pull。

Claude Code（用于 /blueprint 斜杠命令）
Git + GitHub CLI（可选——启用完整的分支/PR/CI 工作流；Blueprint 检测到缺失时会自动切换到直接模式）

灵感来源于 antbotlab/blueprint —— 上游项目和参考设计。

🇺🇸English

Blueprint — Construction Plan Generator

Turn a one-line objective into a step-by-step construction plan that any coding agent can execute cold.

When to Use

Breaking a large feature into multiple PRs with clear dependency order
Planning a refactor or migration that spans multiple sessions
Coordinating parallel workstreams across sub-agents
Any task where context loss between sessions would cause rework

Do not use for tasks completable in a single PR, fewer than 3 tool calls, or when the user says "just do it."

How It Works

Blueprint runs a 5-phase pipeline:

Research — Pre-flight checks (git, gh auth, remote, default branch), then reads project structure, existing plans, and memory files to gather context.
Design — Breaks the objective into one-PR-sized steps (3–12 typical). Assigns dependency edges, parallel/serial ordering, model tier (strongest vs default), and rollback strategy per step.
Draft — Writes a self-contained Markdown plan file to plans/. Every step includes a context brief, task list, verification commands, and exit criteria — so a fresh agent can execute any step without reading prior steps.
Review — Delegates adversarial review to a strongest-model sub-agent (e.g., Opus) against a checklist and anti-pattern catalog. Fixes all critical findings before finalizing.
Register — Saves the plan, updates memory index, and presents the step count and parallelism summary to the user.

Blueprint detects git/gh availability automatically. With git + GitHub CLI, it generates full branch/PR/CI workflow plans. Without them, it switches to direct mode (edit-in-place, no branches).

Examples

Basic usage

/blueprint myapp "migrate database to PostgreSQL"

Produces plans/myapp-migrate-database-to-postgresql.md with steps like:

Step 1: Add PostgreSQL driver and connection config
Step 2: Create migration scripts for each table
Step 3: Update repository layer to use new driver
Step 4: Add integration tests against PostgreSQL
Step 5: Remove old database code and config

Multi-agent project

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

Produces a plan with parallel steps where possible (e.g., "implement Anthropic plugin" and "implement OpenAI plugin" run in parallel after the plugin interface step is done), model tier assignments (strongest for the interface design step, default for implementation), and invariants verified after every step (e.g., "all existing tests pass", "no provider imports in core").

Key Features

Cold-start execution — Every step includes a self-contained context brief. No prior context needed.
Adversarial review gate — Every plan is reviewed by a strongest-model sub-agent against a checklist covering completeness, dependency correctness, and anti-pattern detection.
Branch/PR/CI workflow — Built into every step. Degrades gracefully to direct mode when git/gh is absent.
Parallel step detection — Dependency graph identifies steps with no shared files or output dependencies.
Plan mutation protocol — Steps can be split, inserted, skipped, reordered, or abandoned with formal protocols and audit trail.
Zero runtime risk — Pure Markdown skill. The entire repository contains only .md files — no hooks, no shell scripts, no executable code, no package.json, no build step. Nothing runs on install or invocation beyond Claude Code's native Markdown skill loader.

Installation

This skill ships with Everything Claude Code. No separate installation is needed when ECC is installed.

Full ECC install

If you are working from the ECC repository checkout, verify the skill is present with:

test -f skills/blueprint/SKILL.md

To update later, review the ECC diff before updating:

cd /path/to/everything-claude-code
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

Vendored standalone install

If you are vendoring only this skill outside the full ECC install, copy the reviewed file from the ECC repository into ~/.claude/skills/blueprint/SKILL.md. Vendored copies do not have a git remote, so update them by re-copying the file from a reviewed ECC commit rather than running git pull.

Requirements

Claude Code (for /blueprint slash command)
Git + GitHub CLI (optional — enables full branch/PR/CI workflow; Blueprint detects absence and auto-switches to direct mode)

Source

Inspired by antbotlab/blueprint — upstream project and reference design.

Weekly Installs

Repository

affaan-m/everyt…ude-code

GitHub Stars

72.1K

First Seen

1 day ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex28

github-copilot26

kimi-cli26

amp26

cline26

gemini-cli26

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

136,300 周安装