概述
自訂 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)"]