blueprint

blueprint

熱門

將一行目標轉換為逐步建構計畫,適用於多階段、多代理人的工程專案。每個步驟都包含自足的上下文簡報,讓全新的代理人也能直接執行。包含對抗式審查關卡、相依性圖表、平行步驟偵測、反模式目錄與計畫變更協定。觸發時機:使用者要求針對複雜的多 PR 任務提出計畫、藍圖或路線圖,或描述需要多個階段完成的工作。不觸發時機:任務可在單一 PR 或少於 3 次工具呼叫內完成,或使用者說「直接做」。

23萬星標
3.5萬分支
更新於 2026/7/17
SKILL.md
readonlyread-only
name
blueprint
description

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 階段流程:

  1. 研究 — 前置檢查(git、gh 認證、遠端、預設分支),然後讀取專案結構、既有計畫與記憶檔案以收集上下文。
  2. 設計 — 將目標拆分為每個 PR 一個步驟(通常 3–12 個)。為每個步驟指定相依邊、平行/序列順序、模型層級(最強 vs 預設)與回退策略。
  3. 草稿 — 將自足的 Markdown 計畫檔案寫入 plans/。每個步驟包含上下文簡報、任務清單、驗證指令與退出條件,讓全新的代理人無需閱讀先前步驟即可執行任何步驟。
  4. 審查 — 將對抗式審查委派給最強模型的子代理人(例如 Opus),依據檢查清單與反模式目錄進行審查。在定稿前修正所有重大發現。
  5. 註冊 — 儲存計畫、更新記憶索引,並向使用者呈現步驟數量與平行度摘要。

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 — 上游專案與參考設計。