設定檔
選擇要安裝哪些工作流程,以及它們是以技能、指令或兩者形式安裝。
設定檔是您對要跨機器安裝哪些 OpenSpec 工作流程(AI 工具中的技能和指令)的偏好。預設設定檔是 core。包含或排除工作流程後,您的選擇會儲存為 custom 設定檔。
核心集
core 設定檔安裝六個工作流程,涵蓋從構想到封存的完整循環:
| 工作流程 | 用途 |
|---|---|
explore | 在想法變成變更提案之前先思考清楚 |
propose | 建立變更提案並一步產生所有規劃產出 |
apply | 實作變更提案的任務 |
update | 修訂變更提案現有的規劃產出 |
sync | 將變更提案的規格更新合併到 specs/,但不封存 |
archive | 將已完成的變更提案移至封存區 |
每個工作流程都連結到其完整契約:參數、建立的內容以及回應的內容。
擴展集合:選擇性工作流程
除了核心集之外,還有六個工作流程可用。其中三個(new、continue、ff)逐一建立變更提案的產出,而非像 propose 那樣一次全部建立。
| 工作流程 | 用途 |
|---|---|
new | 以空白鷹架開始一個變更提案 |
continue | 一次建立變更提案中下一個規劃產出 |
ff | 一次建立變更提案及其實作所需的所有規劃產出 |
verify | 檢查實作是否符合變更提案的產出 |
bulk-archive | 一次封存多個變更提案 |
onboard | 透過完成一個真實的變更提案來學習工作流程 |
要更改集合,執行互動式選擇器:
bash
openspec config profile選擇器會詢問要設定什麼(交付方式、工作流程或兩者),然後列出所有十二個工作流程作為核取方塊,已安裝的項目會勾選。任何不完全是核心六個的選擇都會儲存為 custom 設定檔,因此您也可以取消勾選不使用的核心工作流程。
交付方式:技能、指令或兩者
交付方式是設定檔設定,可讓您選擇只安裝技能或只安裝指令。預設值是 both。設定您的專案說明了這兩種形式以及為什麼兩者都存在。此欄位的確切契約請參閱 CLI 設定 (config.json)。
兩種更改方式:
互動式:執行 openspec config profile 並選擇「僅交付方式」。以下是切換到僅技能的方式:
目前設定檔設定
Delivery: both
? 您要設定什麼?僅交付方式
? 交付模式(工作流程安裝方式):僅技能
設定變更:
delivery: both -> skills
? 立即套用變更到此專案?(Y/n) y直接:一個指令,無需提示:
bash
openspec config set delivery skills # 或:both, commands交付方式不會變更設定檔名稱。core 和 custom 僅描述工作流程集合,切換回 core 會保留您的交付方式設定。
切換設定檔
切換分為兩個步驟:在您的機器上變更設定檔,然後更新每個專案以套用。
變更設定檔:
bashopenspec config profile # 互動式 openspec config profile core # 重設為核心六個(保留交付方式)在您工作的每個專案中執行更新:
bashopenspec update
當您目前的目錄是現有的 OpenSpec 專案時,互動式流程會主動為您在該處執行步驟 2。