Blueprint — 建構計劃產生器 是做什麼的?
將一個句子描述的目標轉化為逐步的建構計劃,讓任何編碼代理都能無縫執行。
使用時機
- 將大型功能拆解為多個 PR,並明確依賴順序
- 規劃跨越多個會話的重構或遷移
- 協調子代理之間並行工作流程
- 任何因會話間上下文遺失而導致重做的工作
請勿使用於可在單一 PR 內完成、少於 3 次工具呼叫的任務,或當使用者說「直接做」的時候。
運作方式
Blueprint 執行一個五階段流程:
- 研究 — 預先檢查(git, gh auth, remote, default branch),然後讀取專案結構、現有計劃與記憶檔案以收集上下文。
- 設計 — 將目標分解為 3 到 12 個適合單一 PR 的步驟,為每個步驟指定依賴邊緣、並行/序列順序、模型層級(最強或預設)以及回滾策略。
- 草稿 — 在
plans/目錄中寫入一個自包含的 Markdown 計劃檔案。每個步驟都包含上下文摘要、任務清單、驗證指令與退出標準,讓全新的代理無需閱讀先前步驟即可執行任意步驟。 - 審查 — 將對抗性審查委派給最強模型子代理(例如 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 的 diff 再更新:
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——上游專案與參考設計。