整合
整合透過命令、技能或配方,將 Spec Kit 連接到你的 AI 程式代理。若只需要共用骨架而不需要代理,請使用 none。在下方選擇一個整合,查看其先決條件、設定、呼叫語法,以及整合專屬的選項或限制。
設定你的代理
CLI 的先決條件與安裝方式請參閱安裝指南,你的第一個流程請參閱 SDD 快速入門。
若是新專案:
specify init my-project --integration <key>
請在你的程式代理內呼叫流程命令,不要在終端機中呼叫。文件通常使用 /speckit.* 記法,但你的代理可能使用連字號技能、$ 技能或其他原生形式。請參閱你所用整合的頁面與命令呼叫方式比較。
產生的技能版本
產生的 SKILL.md frontmatter 會在供應元件的版本已知時包含 metadata.version。核心技能記錄產生它的 Specify CLI 版本;擴充功能與預設集技能則記錄各自元件的版本。該值為字串;版本未知時會省略此鍵。
既有的中繼資料,包括 metadata.author 與 metadata.source,維持原有含義。透過既有操作重新產生的技能,包括在預設集移除後還原的技能,會記錄產出元件的版本。已在磁碟上的技能不會自動重寫;此中繼資料不會執行過時技能偵測或升級。
加入另一個代理
在已初始化的專案中,使用 specify integration install <key>。請查看該代理指南中的多重安裝安全性狀態,並遵循共用的多重安裝規則。
安裝另一個整合不會變更預設值。使用 specify integration use <key> 將它啟用。
移除代理
使用 specify integration uninstall <key> 移除某個代理的 Spec Kit 整合,而不是代理應用程式本身。已修改檔案的處理方式與清理例外請參閱解除安裝參考。
若要改為取代某個整合,請使用 specify integration switch <key>。
在團隊中工作
使用混合代理的團隊可以從不綁定代理的專案開始:
specify init my-project --integration none
每位開發者都在自己的本機簽出中切換到所選的代理:
specify integration switch <key>
開發完成後,在將提交放入暫存區之前切換回來:
specify integration switch none
重要
請勿手動編輯 Spec Kit 產生的代理命令或技能。請在經過審查的預設集或專案本機覆寫中維護自訂內容。
提交前,請使用 specify integration status 確認 none 是唯一已安裝且為預設的整合。請檢查 Git 差異與任何保留的代理檔案。
團隊可以為已提交的基線加入 CI 檢查,也可以選擇性地為暫存檔案加入預先提交檢查。
選擇整合
以 --integration <key> 使用下方顯示的確切鍵值。以 CLI 為基礎的整合需要安裝代理的 CLI;以 IDE 為基礎的整合則透過代理在你 IDE 中的聊天視窗執行。每個頁面都連結到該代理的安裝文件。
| 整合 | 鍵 |
|---|---|
| Alquimia AI | alquimia |
| Amp | amp |
| Antigravity | agy |
| Auggie CLI | auggie |
| Claude Code | claude |
| Cline | cline |
| CodeBuddy CLI | codebuddy |
| Codex CLI | codex |
| Command Code | command-code |
| Cursor | cursor-agent |
| DeepSeek Harness | dsh |
| Devin for Terminal | devin |
| Docker Agent | docker-agent |
| Factory Droid | droid |
| Firebender | firebender |
| Forge | forge |
| Gemini CLI | gemini |
| GitHub Copilot | copilot |
| Goose | goose |
| Grok Build | grok |
| Hermes | hermes |
| IBM Bob | bob |
| Junie | junie |
| Kilo Code | kilocode |
| Kimi Code | kimi |
| Kiro CLI | kiro-cli |
| Lingma | lingma |
| MiniMax Code | mcode |
| Mistral Vibe | vibe |
| Muse Code | muse |
| None:僅共用骨架 | none |
| Oh My Pi | omp |
| opencode | opencode |
| Pi Coding Agent | pi |
| Qoder CLI | qodercli |
| Qwen Code | qwen |
| RovoDev | rovodev |
| SHAI (OVHcloud) | shai |
| Tabnine CLI | tabnine |
| Trae | trae |
| ZCode | zcode |
| Zed | zed |
| Generic:自備代理 | generic |
共用管理與外部整合
整合 CLI 參考記載了共用的安裝、升級、移除、狀態、型錄與預設選取行為。這些規則跨整合適用,不會在每個頁面上重複。各指南也會指出是否支援工作流程 CLI 分派;不需要 CLI 的 IDE 設定,並不表示工作流程步驟可以在沒有 CLI 的情況下執行。
對於此處未列出的代理,請使用 generic 整合或探索外部轉接器。授權執行外部轉接器程式碼之前,請先審查它。型錄探索不是安全背書;預設的社群型錄僅供探索。信任與安裝要求請參閱透過型錄安裝的外部轉接器。
API 參考記載受支援的 Python 轉接器契約。型錄參考說明描述檔與型錄中繼資料。開發內建整合或發布外部轉接器,請參閱貢獻整合。