Skip to content

設定檔 ​

選擇要安裝哪些工作流程,以及它們是以技能、指令或兩者形式安裝。

設定檔是您對要跨機器安裝哪些 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 會保留您的交付方式設定。

切換設定檔 ​

切換分為兩個步驟:在您的機器上變更設定檔,然後更新每個專案以套用。

  1. 變更設定檔:

    bash
    openspec config profile        # 互動式
    openspec config profile core   # 重設為核心六個(保留交付方式)
  2. 在您工作的每個專案中執行更新:

    bash
    openspec update

當您目前的目錄是現有的 OpenSpec 專案時,互動式流程會主動為您在該處執行步驟 2。