適用情境
完整嚴格工作流 (Full Flow) 是最嚴謹、防錯能力最強的開發模式。推薦在以下情境使用:
- 大規模的功能模組重構。
- 設計方案具有高風險或存在多個未知數 (Unknowns)。
- 多人協作同一個模組,可能產生規格衝突。
此流程雖然步驟較多,但能保證在開工前想清楚、在實作時步步穩健、在歸檔前完全通過多維度審查。
核心步驟
1. 深度探索:/opsx:explore
在建立 Change 前,先進入探索模式,深入 codebase 了解現有架構,繪製 ASCII 架構圖,評估第三方套件或方案的優缺點。
2. 建立空計畫:/opsx:new
當思路清晰後,使用 /opsx:new 建立一個空的變更計畫,決定要使用的 Schema 模式,但先不生成文件。
3. 智慧快進:/opsx:ff
準備開始實作前,執行 /opsx:ff 快進補齊所有規劃產物。這一步會一次產生完整的提案、設計與任務清單。
4. 精細實作:/opsx:apply
執行實作指令,小步快跑地修改程式碼。遇到人工檢查點時,手動進行驗收測試。
5. 三維驗證:/opsx:verify
歸檔前,主動執行 /opsx:verify 進行完整性、正確性與一致性的三維度靜態審查,確保規格與設計完全落實。
6. 同步與歸檔:/opsx:sync 與 /opsx:archive
執行 /opsx:sync 同步規格,接著執行 /opsx:archive 歸檔清理變更計畫。
v1.12.0:把 findings-only 報告接進 CI
完整工作流在 CI 階段可加入:
openspec validate --all --report findings
這會把報告聚焦在 error / warning / informational findings,但不改 exit code。建議把它放在 /opsx:verify 後、archive 前,作為 reviewer 可快速掃過的最後一層機器驗證。
同時,Explore、Propose 與 FF 都應遵守 v1.12.0 的 code-grounded planning:先讀 code / tests / docs,只有 repository 無法回答的決策才回頭問人。