整合

整合透過命令、技能或配方,將 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 轉接器契約。型錄參考說明描述檔與型錄中繼資料。開發內建整合或發布外部轉接器,請參閱貢獻整合。

另請參閱