/opsx:continue 指令詳解

指令用途

/opsx:continue 是一個 實驗性 (Experimental) 指令。在漸進式 (Incremental) 的開發流程中，它是用來推進規劃進度的核心指令。

當你使用 /opsx:new 啟動計畫後，規格文件需要依照依賴關係逐步生成。此時，每次調用 /opsx:continue，AI 助手就會：

1. 自動檢查當前變更計畫 (Change) 的進度與檔案狀態。
2. 找出下一個已經解鎖（處於 ready 狀態）的規格或設計文件。
3. 取得該文件的 instructions (指引範本) 並生成內容。
4. 一次只生成一個檔案，隨即暫停，交由開發者審查與引導。

這套機制能確保每一份文件在生成時，都經過開發者的即時檢視，避免 AI 在錯誤的假設下連續生成大量無用文檔。

運作流程

1. 推斷或選擇計畫：若未提供計畫代號，AI 助手會查詢當前專案中進行中的計畫。若有多個計畫，會使用互動問答工具讓使用者選擇。
2. 檢查進度狀態：執行 openspec status --change "<name>" --json 取得進度。
   • 若 isComplete 為 true，代表所有文件已備齊，AI 會提示可以直接進入實作 /opsx:apply。
   • 若有檔案處於 ready 狀態，則挑選最優先的單一產物。
3. 單步生成 (Single-step Generation)：獲取該產物的範本後寫入檔案，顯示進度，並立刻暫停，提示可再次呼叫指令。

實戰對話範例

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

範例一：生成下一個解鎖的產物（由 Proposal 推進至 Spec）

• Context: 變更計畫 add-logout-feature 的 proposal.md 已經完成。
• You:

  /opsx:continue
  

• AI:

  偵測到進行中的計畫為：add-logout-feature (使用 spec-driven 工作流)。

  檢查目前狀態：proposal.md 已完成。下一個解鎖的產物為 specs/logout-flow/spec.md (規格書)。

  正在為您起草 specs/logout-flow/spec.md：

  • 規劃驗收場景：Scenario: Perform logout 與 Scenario: Token invalidated。

  目前進度：1/4 規劃檔案已完成。

  成功建立規格書！下一個解鎖的檔案是 design.md (設計方案)。 請輸入 /opsx:continue 繼續生成下一個產物。

範例二：多個計畫衝突時的選擇機制

• You:

  /opsx:continue
  

• AI (透過問答視窗呈現選項):

  請問您想要繼續哪一個變更計畫？

  1. 🌟 (推薦) add-logout-feature (2/4 檔案完成，10 分鐘前更新)
  2. cache-orders-api (0/3 檔案完成，2 小時前更新)

  [使用者點選了第 1 項]

  好的，正在繼續 add-logout-feature。下一個解鎖的產物是 design.md⋯⋯

範例三：所有必要產物均已完成時

• You:

  /opsx:continue
  

• AI:

  偵測到進行中的計畫：add-logout-feature。

  目前進度：4/4 規劃檔案已全數完成！

  • proposal.md (done)
  • specs/logout-flow/spec.md (done)
  • design.md (done)
  • tasks.md (done)

  🎉 恭喜！本變更計畫的規劃階段已全部就緒。 您現在可以直接執行實作指令開始編寫程式碼：

  /opsx:apply