Theme / v1.12.0

OpenSpec

規格驅動開發

基礎觀念

v1.9:Command Code 支援與可驗證歸檔

用新的 command-code 初始化目標取得 /opsx-* 指令,並以 validate --archived 把未完成的歸檔擋在 CI 前。

建立 Command Code 的 /opsx-* 指令

v1.9.0 新增 adapter-backed 的 command-code 工具目標。執行:

openspec init --tools command-code

會安裝 OpenSpec workflow skills,並在 .commandcode/commands/ 產生 /opsx-* slash commands,讓 Command Code 用戶也能以既有指令完成 explore、propose、apply、archive 流程。

用 validate –archived 守住歸檔品質

openspec validate --archived 是 opt-in 檢查:它會確認 changes/archive/ 中每個變更的 tasks.md 都已全數勾選,否則以非零狀態結束。把這條命令放進 pre-commit 或 CI,能在「尚未完成就歸檔」的工作進入歷史之前攔下它,不會改變既有 validate 的行為。

範圍外的工作與錯誤更早浮出

listvalidate --all/--changes/--specsschemas 在 OpenSpec root 之外執行時現在會明確失敗(非零狀態),不再默默解析出空 root;單一變更的 validate <name> 維持不變。agent 在 apply 期間遇到超出變更範圍的工作時,指引也改為直接向使用者說明,而不是默默略過,避免「做完才發現範圍被悄悄縮小」。

更忠實的規格重建

delta 同步現在會保留 ## Requirements 前後的空白行,並以單一換行結束檔案;openspec schema fork 改為原地編輯 YAML,保留註解、block-scalar 樣式與 key 順序,規格與 schema 在來回轉換後不會悄悄變形。

來源:OpenSpec v1.9.0 release