Theme / v1.16.0
OpenSpec
規格驅動開發
Foundations
基礎觀念
- 什麼是 Spec-Driven Development?🟢 入門|用白話解釋 spec-driven development 與 OpenSpec 的關係
- OpenSpec 核心觀念🟢 入門|深入了解 OpenSpec 的核心概念:Change、Capability、Scenario、Spec Delta 等關鍵名詞
- 安裝與初始化🟢 入門|如何在既有專案中安裝 OpenSpec 工具並初始化規格目錄
- 你的第一個 Change🟢 入門|完整走一遍 OpenSpec 變更計畫的生命週期:Propose、Apply、Archive
- OpenSpec 目錄結構🟢 入門|理解 openspec/、.omx/ 與 .opencode/ 目錄的分工與 Git 忽略規範
- v1.8:共享 agents 目標與安全歸檔🟡 中階|使用新的 agents 初始化目標、提前驗證 scenario,並在 archive 退役 capability。
- v1.9:Command Code 支援與可驗證歸檔🟡 中階|用新的 command-code 初始化目標取得 /opsx-* 指令,並以 validate --archived 把未完成的歸檔擋在 CI 前。
- v1.11:差異檢視與工作區狀態🟡 中階|用 show --diff 只看真正改動的行、用 status --all 一眼掌握所有進行中變更,並認識 Explore 先問再寫的新規矩與 v1.10.0 的實用改善。
- v1.12.0:Findings-only 驗證與 Code-grounded Planning🟡 中階|學會用 findings-only 報告降低 CI 噪音,並理解 v1.12.0 的 Propose、FF、Explore 為何改成先讀 code、tests 與 docs 再規劃。
- v1.13.x:供應鏈安全與可靠的 Archive🟡 中階|理解 v1.13.0 與 v1.13.1 的重點:在未審查的 repo 中安全執行、status 的 Next 提示、apply 對無 delta specs 的警告,以及 archive 對 bullet markers 與重複 section 的正確性修正。
- v1.13.2:Verify 誠實回報與 Windows Archive 修復🟡 中階|1.13.x 系列的收尾修正:/opsx:verify 回報實際檢查了什麼、removed 與 renamed requirement 的判定修正,以及 archive 在 Windows 上不再遺留 lock 檔或中途 rollback。
- v1.14.0:十個新工具與 Archived Changes🟡 中階|v1.13.2 → v1.14.0 的升級重點:新增十個 AI 工具支援、可瀏覽 archived changes、workflow 狀態進入 view,以及 apply / archive 的可靠性修正。含互動測驗與升級檢查清單。
- v1.14.2:x- 擴充鍵、更快的 Tab 與誠實的 Verify🟡 中階|掌握 OpenSpec v1.14.2 的重點:.openspec.yaml 的 x- 前綴擴充鍵(自己的 metadata 不再讓 --strict 失敗)、Tab completion 載入 48 模組、delta 文字歸檔遺漏警告、REMOVED requirement 的誠實驗證與 symlink 支援。含互動測驗與檢查清單。
- v1.14.3:Linked specs 與更安全的 globs🟡 中階|掌握 OpenSpec v1.14.3 的三個主軸:spec.md 可 symlink 到專案其他地方、glob artifact 寫入前路徑檢查(防離開 change 目錄)、移除 braces 依賴與修復 validate 在 pre-commit hooks 掛住。含互動測驗與檢查清單。
- v1.15.0:免 Node.js 獨立安裝與 update --dry-run🟡 中階|OpenSpec v1.15.0(2026-10-24 發布):一句指令免 Node.js 安裝(macOS/Linux/Windows,x64 與 arm64)、openspec update --dry-run 預覽變更,以及 --json 啟動加速、feedback 表單與 new change/opsx:verify 修復。含互動測驗與升級檢查清單。
- v1.16.0:openspec.dev 一鍵安裝、validate 情境檢查與 Node.js 22 下限🟡 中階|OpenSpec v1.16.0(2026-10-30 發布):Breaking——npm 安裝需 Node.js 22.12.0 以上;新增從 openspec.dev 一鍵安裝(release 檔改 .tar.gz/.zip)、openspec validate 的 Scenario 步驟檢查與 store 建議,並修復 config.yaml 驗證、zsh completion 等問題。含互動測驗與升級檢查清單。