Skip to content

概述 ​

自訂 OpenSpec 的選項。

OpenSpec 支援多種自訂選項。此頁面說明每個選項的變更內容及使用時機。

您可以自訂的項目 ​

選項變更內容使用時機
設定檔安裝哪些工作流程,以及是作為技能、指令或兩者您需要額外的工作流程和作業模式,或移除不需要的工作流程
專案設定每次工作流程執行時注入的指示:情境、規則和作業指引(config.yaml)您希望變更以您的方式規劃,例如任務一律包含 Playwright 測試
結構描述OpenSpec 產生的內容:成品、其順序及其範本變更應該產生不同的規劃檔案、區段或格式

不確定該使用哪一個? ​

設定和結構描述是兩個層級的自訂。根據您想參與的程度來選擇:

  • 從專案設定開始:它較輕量,對大多數專案而言已足夠。您保留標準成品,並在其上新增自己的情境和規則。
  • 當新增不足以滿足需求時,分支結構描述:設定只能在核心工作流程之上新增。它可以新增像是「任務一律包含測試」的規則,但無法移除設計文件或重新命名檔案。這屬於結構描述的範疇。分支讓您擁有自己的副本可供編輯。

此處的「分支」是指 openspec schema fork 指令,而非分支 git 儲存庫。結構描述 中有詳細資訊。

flowchart LR
    a["工作流程應該了解我的技術棧和慣例"] --> config
    b["一個成品需要額外規則,例如任務一律包含測試"] --> config
    c["不同的成品、檔案名稱或文件結構"] --> schema
    d["內建指示提到我的團隊做法不同的事"] --> schema
    config["專案設定<br/>(config.yaml)"]
    schema["分支結構描述<br/>(openspec schema fork)"]