/opsx:new 指令詳解

指令用途

/opsx:new 是一個 實驗性 (Experimental) 指令。它的用途是啟動一個新的變更計畫 (Change)，但與 /opsx:propose 一步到位自動生成所有檔案的作法不同，/opsx:new 採用的是漸進式 (Incremental) 的生成流程。

當你執行 /opsx:new 時，它只會建立變更計畫的目錄結構，並找出該工作流架構 (Schema) 下第一個需要撰寫的規劃產物（通常是 proposal.md），顯示其範本 (Template)，然後立刻停下來等待使用者的引導。這非常適合需要高度人工控管、或需要一步步細緻調校設計的複雜任務。

運作流程

1. 取得輸入：使用者傳入 Change 名稱或描述，AI 助手將其轉換為 kebab-case 格式。若該名稱的計畫已存在，會提示改用 /opsx:continue。
2. 選擇 Schema：預設採用 spec-driven。如果使用者明確指定其他工作流，則附加 --schema 參數。
3. 建立計畫目錄：執行 openspec new change "<name>"。
4. 檢查首個產物：執行 openspec status 找出第一個處於 ready 狀態的產物，並執行 openspec instructions <artifact-id> 取得其範本。
5. 中斷並等待：將首個產物的範本呈現給使用者，然後中斷執行，等待下一個指令（如 /opsx:continue）。

實戰對話範例

以下是三個不同情境下的對話範例：

範例一：漸進式建立新計畫（新增登出功能）

• You:

  /opsx:new "建立登出功能"
  

• AI:

  好的，我已為您建立變更計畫 add-logout-feature (使用預設 spec-driven 工作流)。

  目前的進度為：0/4 規劃檔案已完成。

  依據依賴順序，第一個需要建立的檔案是 proposal.md。以下是該檔案的結構範本：

  ## Why
  <!-- 說明為什麼需要此變更 -->
  
  ## What Changes
  <!-- 說明要修改哪些部分 -->
  

  準備好開始撰寫第一個產物了嗎？ 請執行 /opsx:continue，或者直接告訴我這次變更的背景，我會為您起草提案。

範例二：自訂工作流 Schema

• You:

  /opsx:new "重構日誌系統" --schema "doc-first"
  

• AI:

  好的，已使用 doc-first 工作流建立變更計畫 refactor-logging-system。

  目前的進度為：0/3 規劃檔案已完成。

  依據該工作流，第一個需要建立的檔案是 architecture-spec.md。以下是該檔案的結構範本：

  # 架構規格書 (Architecture Spec)
  ...
  

  請確認架構需求，準備就緒後請輸入 /opsx:continue 繼續生成。

範例三：計畫已存在時的防呆機制

• You:

  /opsx:new "為教學網站加上深色模式切換按鈕"
  

• AI:

  ⚠️ 偵測到名為 add-dark-mode 的變更計畫已經存在於 openspec/changes/ 中。

  為了避免覆蓋既有的設計，我已中斷本次初始化。

  • 如果您想繼續該計畫的規劃或實作，請執行：

    /opsx:continue add-dark-mode
    

  • 如果您想使用其他名稱建立新計畫，請重新輸入，例如：/opsx:new add-dark-mode-v2。