預設集
預設集是可堆疊、依優先順序排列的 Spec Kit 範本、命令與指令碼自訂組合。用預設集來落實組織標準、讓 Spec Kit 流程配合你的方法論,或調整術語,而不必分叉核心檔案。擴充功能是增加能力;預設集改變的是既有能力的運作方式。
重要
安裝第三方預設集之前,請先審查其原始碼。社群型錄只是探索管道,不是安全性背書。維護者只檢查型錄項目的完整性與格式,不會審查、稽核、背書或支援社群預設集的程式碼。
快速入門
請在已用 specify init 初始化的專案內執行預設集命令:
# Discover presets without installing them
specify preset search
specify preset info lean
# Install a bundled preset
specify preset add lean
# Inspect installed presets and template resolution
specify preset list
specify preset resolve spec-template
# Remove it and restore the surviving layers
specify preset remove lean
若是你自行撰寫或已審查過的預設集,請用 specify preset add --dev ./my-preset 安裝本機副本,或用 specify preset add --from <archive-url> 安裝固定版本的發布封存檔。本機安裝會複製原始碼,不是連結到開發目錄的即時連結。社群搜尋結果本身並不允許以 ID 安裝。
預設集如何生效
範本決定產出內容,例如規格或計畫。命令包含程式代理遵循的指示,用來產出這些內容。指令碼提供可執行的行為,安裝時須以審查其他程式碼的同等標準看待。
每個邏輯檔名都會透過以下各層獨立解析:
| 優先順序 | 層級 |
|---|---|
| 最高 | .specify/templates/overrides/ 中的專案本機覆寫 |
| 其次 | 已啟用的預設集,依優先順序、再依預設集 ID 排序 |
| 其次 | 已啟用的擴充功能貢獻,依優先順序、再依擴充功能 ID 排序 |
| 最低 | Spec Kit 核心預設值 |
數字較小的優先順序優先。預設集與擴充功能的優先順序只在各自的層內排序;擴充功能無法靠選一個較小的數字就凌駕於預設集層之上。
範本與指令碼會在需要時解析。命令則是在安裝與協調期間,具體化為使用中整合的命令檔或技能;代理不會在每次呼叫時重新解析整個堆疊。切換預設整合會為該整合重新搭建已啟用的預設集。通用整合不會註冊預設集的命令或技能覆寫。
未安裝任何預設集時,專案覆寫、擴充功能貢獻與核心預設值仍會繼續生效。
堆疊與組合
請以不同的優先順序安裝多個已審查的預設集:
specify preset add --dev ./team-base --priority 10
specify preset add --dev ./compliance --priority 5
specify preset set-priority compliance 3
若兩個預設集都以預設的 replace 策略提供 spec-template,compliance 會完全勝出。只有 team-base 提供的檔案仍會使用該預設集。優先順序相同時,依預設集 ID 的字母順序解析。
預設集可以擴增較低層的內容,而不必取代它們:
| 策略 | 效果 |
|---|---|
replace |
完全使用這一層;忽略較低層 |
prepend |
把這一層放在較低優先順序內容之前 |
append |
把這一層放在較低優先順序內容之後 |
wrap |
在這一層的佔位符處插入較低優先順序的內容 |
範本與命令支援全部四種策略。指令碼只支援 replace 與 wrap。組合需要一個較低層的 replace 基礎;包裝層必須包含適當的佔位符。API 參考文件定義了確切的規則。
憲章生命週期
初始化時會以解析後的 constitution-template 將 .specify/memory/constitution.md 植入一次,並保留既有的憲章。之後執行 /speckit.constitution 時,會解析目前組合後的範本,並以即時憲章作為專案專屬值與修訂的依據。
預設情況下,安裝、移除、啟用、停用或調整預設集優先順序時,不會重寫即時憲章。內建的 constitution-sync 預設集選擇加入了有防護的安裝期具體化與命令期傳播功能。啟用期間,堆疊變更可能會刷新未經更動的已產生憲章,但自行撰寫或手動編輯的憲章會受到保護。安裝此預設集也可以植入缺少的憲章。
常見問題
如何查看正在使用哪個檔案?
範本請用 specify preset resolve spec-template,命令請用 specify preset resolve speckit.specify。組合後的輸出可能由多個貢獻檔案組成,而非只有一個最終來源路徑。如需完整的成品堆疊(含隱藏層),請用 specify artifact info <name> --json。
停用與移除相同嗎?
不同。停用會將預設集排除於後續解析之外,但先前已註冊的命令與技能會留在原處。若需要清理那些已交付的覆寫並還原存續的各層,請使用移除。
由誰支援預設集?
請透過預設集作者的儲存庫聯絡作者。納入社群型錄並不會把維護或支援責任轉移給 Spec Kit 維護者。