Turn a one-line objective into a step-by-step construction plan for multi-session, multi-agent engineering projects. Each step has a self-contained context brief so a fresh agent can execute it cold. Includes adversarial review gate, dependency graph, parallel step detection, anti-pattern catalog, and plan mutation protocol. TRIGGER when: user requests a plan, blueprint, or roadmap for a complex multi-PR task, or describes work that needs multiple sessions. DO NOT TRIGGER when: task is completable in a single PR or fewer than 3 tool calls, or user says "just do it".
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 "將資料庫遷移至 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 儲存庫檢出工作,請使用以下指令確認技能存在:
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 — 上游專案與參考設計。






