如何依你的工作方式調整 Spec Kit
三套第一方流程是起點,不是上限。你可以保留內建的 SDD 流程、加入錯誤修復或評估、把某套流程調整成符合組織需要,或帶來一套完全不同的流程。
選對建構模組
| 目標 | 使用 |
|---|---|
| 把 Spec Kit 連接到程式代理,或調整其命令/skill 的交付方式 | 整合 |
| 新增命令、能力或流程 | 擴充功能 |
| 整合外部工具或服務 | 擴充功能 |
| 變更規格、計畫或任務的格式或術語 | 預設集 |
| 在既有範本中落實組織或法規標準 | 預設集 |
| 發布可重複使用的領域專屬範本 | 覆寫用預設集;新命令隨附的範本用擴充功能 |
| 在單一專案中做一次性的範本調整 | 專案本地覆寫 |
| 自動化多步驟流程 | 工作流程 |
| 為工作流程新增自訂可執行步驟類型 | 工作流程步驟套件 |
| 一次佈建完整的角色型設定 | 套件組 |
整合決定命令與 skill 如何交付給你的程式代理;這與連接外部工具或服務的擴充功能不同。請見整合指南了解支援的代理與設定,或見貢獻整合來開發配接器。
工作流程步驟套件擴充了工作流程可用的步驟類型。撰寫與執行方式請參閱自訂步驟套件,安裝方式請參閱步驟 CLI,探索與貢獻指引請參閱社群工作流程步驟。安裝或使用可執行套件前,請先檢閱其內容。
擴充功能:新增能力
擴充功能透過命令、範本、script 與 hook 擴展 Spec Kit 能做的事。它們可以加入領域專屬流程、外部整合,或核心之外的開發階段。
specify extension search
specify extension add <extension-name>
例如 Jira 整合、實作後的程式碼檢閱、V-Model 測試追溯,以及專案健康診斷。內建的 bug 與 assess 擴充功能是第一方範例。瀏覽社群擴充功能,或使用擴充功能 CLI 參考進行管理,並參閱擴充功能使用者指南進行設定。
預設集:改變流程的運作方式
預設集覆寫核心以及已安裝擴充功能提供的範本與命令。它們自訂所產出的產出物與指示,不需要新的工具。
specify preset search
specify preset add <preset-name>
使用預設集可以要求法規追溯、強制測試優先的任務排序、在計畫中加入安全性審查關卡,或把工作流程在地化。預設集也能把方法論調整為 Agile、Kanban、Waterfall、jobs-to-be-done 或領域驅動設計。pirate-speak 示範說明了術語可以改變到什麼程度。
多個預設集可以依優先順序堆疊。範例請參閱社群預設集,堆疊與組合方式請參閱預設集指南,安裝與管理方式請參閱CLI 參考。
專案本地覆寫與解析
若要在單一專案中做一次性自訂,把範本覆寫放在 .specify/templates/overrides/,而不是建立可重複使用的預設集。預設的替換順序是:
- 專案本地覆寫。
- 已安裝的預設集,依優先順序。
- 已安裝的擴充功能,依優先順序。
.specify/templates/中的 Spec Kit 核心範本。
範本在需要時解析,預設採用第一個符合的項目。命令則不同:安裝擴充功能或預設集會把命令檔案實體化到作用中整合的目錄裡。代理每次呼叫命令時,不會重新解析那一整疊。移除某個覆寫元件後,透過對帳會還原存續的命令層。
若未做任何自訂,套用核心預設值。路徑、優先順序與 prepend/append/wrap 組合方式,以檔案解析參考為準。
套件組:角色型設定
套件組把一組精選的擴充功能、預設集、工作流程與工作流程步驟,打包成一個有版本、針對某個角色或團隊的設定。它的 bundle.yml 資訊清單會釘住各元件,並可指定目標整合;與整合無關的套件組則繼承專案作用中的整合。
specify bundle search
specify bundle info <bundle-id>
specify bundle install <bundle-id>
安裝前請先檢查 info,查看解析後的元件組合。第一方設定請參閱套件組總覽,更新、移除與離線限制請參閱CLI 參考。撰寫時請先從開發套件組與發佈套件組著手。
分享你的自訂成果
社群元件由各自的維護者獨立維護。安裝前請先檢閱原始碼,並自行斟酌使用。探索元件或發佈你自己的元件,請造訪社群指南;若要將流程自動化,請參閱工作流程指南。