Blueprint — 建構計畫產生器 是做什麼的?
將一句目標轉換為逐步的建構計畫,任何編碼代理都能冷啟動執行。
使用時機
- 將大型功能拆解為多個具有明確依賴順序的拉取請求
- 規劃跨越多次會話的重構或遷移
- 協調跨子代理的並行工作流
- 任何會話間上下文遺失會導致重做的任務
請勿使用 於可在單次拉取請求中完成、少於 3 次工具呼叫的任務,或當使用者說「直接做」的時候。
運作方式
Blueprint 執行一個五階段管線:
- 研究 — 前置檢查 (git、gh auth、遠端、預設分支),然後讀取專案結構、現有計畫和記憶體檔案以收集上下文。
- 設計 — 將目標分解為一次拉取請求大小的步驟 (通常 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 —— 上游專案和參考設計。