Blueprint

Blueprint 是什麼？

Blueprint 是程式碼代理的規劃助理。它幫助代理在撰寫程式碼前提出正確問題，然後產生代理可一次執行的 Markdown 計畫。

此工具設計為代理無關，並使用 Q&A 驅動的規劃：它探索程式碼庫並提出多選題問題，這些問題易於回答。輸出旨在浮現您可能未考慮的問題與決策，以可重用規格/計畫的結構呈現。

主要功能

• 程式碼前 Q&A 規劃：Blueprint 適度放慢執行以釐清需求，然後產生結構化計畫。
• 程式碼庫探索：它讀取您的工作空間/程式碼庫，並以此脈絡驅動提問。
• 多選題問題：問題格式化以利快速回答，同時涵蓋重要歧義。
• Markdown 計畫輸出：結果為 Markdown 檔案，供直接交給程式碼代理。
• 代理無關技能（相容 skills.sh）：Blueprint 以相容多個程式碼代理框架的技能形式封裝。
• 內建模板含開放問題區段：包含預設規劃模板，定義概述、預期行為、實作階段、測試策略及開放問題等區段。

如何使用 Blueprint

1. 安裝技能：使用儲存庫中顯示的 npx 指令：npx skills add imbue-ai/blueprint。
2. 啟動規劃工作階段：在程式碼代理中以簡短任務描述呼叫技能（例如 /blueprint Add a caching layer to reduce API calls）。
3. 選擇模板：提示時挑選模板。Blueprint 會探索程式碼庫並開始提問。
4. 回答問題：直到 Blueprint 判定已涵蓋足夠內容。
5. 產生計畫：使用 /blueprint-generate。計畫會寫入格式為 blueprint/<slug>/plan-<slug>.md 的路徑。
6. 如需在聊天中精煉：詢問開放問題（例如「what are the open questions?」），再將計畫交給程式碼代理。

使用情境

• 綠地專案 / 新功能：規劃大型新功能，確保需求、預期行為及測試策略在實作前明確涵蓋。
• 需協調的增量變更：當變更足夠大需小心規格（而非快速編輯）時，Blueprint 可協助結構化決策與階段。
• 研究與實驗：針對新模型、系統或子系統，Blueprint 的 Q&A 流程可將假設與未知捕捉為含開放問題的計畫。
• 處理不熟悉程式碼庫：Blueprint 可探索工作空間並依發現提出澄清問題，降低遺漏關鍵限制的機率。
• 減少代理工作流程的執行錯誤：若代理原本會「急於撰碼」，Blueprint 提供明確計畫檔案，供規劃階段後執行。

常見問題

• 支援哪些程式碼代理框架？ 儲存庫指出相容 Claude Code、Codex CLI、Gemini CLI、Pi agent 等框架及其他相容框架。

• 產生的計畫儲存於何處？ 執行 /blueprint-generate 後，計畫會寫入 blueprint/<slug>/plan-<slug>.md。

• Blueprint 包含哪些模板？ 預設內建兩個模板：Default（區段包含概述、預期行為、實作計畫/階段、測試策略及開放問題）及 Concise（區段包含概述、預期行為及變更）。

• 可自訂計畫結構嗎？ 可以。儲存庫指出提示時可內嵌描述自訂模板，並可經 templates.json 永久新增/編輯模板，讓兩個 Blueprint 技能保持同步。

• Blueprint 限於前端工作嗎？ README 指引建議前端視覺決策為主時較不理想，更適合綠地專案、大型新功能及研究或子系統規劃。

替代方案

• 規格或文件產生器（手動審核風格）：代理自行選擇後產生長規格的工具，與 Blueprint 不同之處在於反轉工作流程——Blueprint 先透過 Q&A 徵求您的輸入。
• 程式碼代理工具中的代理「計畫模式」工作流程：某些代理平台包含自己的規劃模式；Blueprint 定位為專門的規劃助理，產生代理可執行的 Markdown 計畫，並提出簡短、聚焦需求的問題。
• 通用程式碼庫審核助理：替代方案可能摘要或分析儲存庫，但 Blueprint 的獨特輸出是有結構的 Markdown 計畫，包含定義區段及用於執行的開放問題。
• 使用規劃擴充功能之 VS Code 側邊列工作流程：若偏好編輯器整合工具，Blueprint 也提供 VS Code 擴充功能，適用於 VS Code、Cursor 和 Windsurf，這可能與純聊天驅動的代理設定不同。