概述
OpenSpec v1.14.2(2026-10-15 發布)官方摘要:「This release lets you keep your own metadata on a change, makes Tab completion faster, and closes gaps where archive and verify could lose or miss content.」
Extension keys:自己的 metadata(New)
.openspec.yaml 頂層以小寫 x- 開頭的 key 現在是你的——放 tracker id、owner 或其他工具資料(如 x-goal: G-12、x-jiraKey)。OpenSpec 忽略它們,因此 openspec validate --strict 對帶有它們的 change 仍通過。其他未辨識 key 依然會被回報。
更快的 Tab completion(Improved)
Shell completion 在補完 change 或 spec 時,從載入 344 個模組降到 48 個,且不再記錄 usage——按 Tab 不會等待 telemetry。
文字歸檔遺漏警告(Improved)
openspec validate 與 openspec archive 現在會警告:delta spec 含有 archive 不會帶入主 spec 的文字——例如多餘的 ## section、或第一個 requirement 前的散文。與其他警告相同,這些會讓 openspec validate --strict 失敗。
Verify 誠實處理 REMOVED(Improved)
/opsx:verify 先從主 spec 讀回 REMOVED requirement 的原文,再去程式碼裡搜尋;讀不回來時如實回報未驗證,而不是直接通過。
修正(Fixed)
- Symlink 目錄:
openspec archive接受openspec/、openspec/changes、openspec/specs為 symlink(例如連到共享 docs repo)。 - 自訂 schema:Explore 不再提議在不定義
design.md的 schema 下建立該檔。 - Glob artifacts:update workflow 不再拒絕在部分寫入的 glob artifact 下建新檔。
- 深層花括號:
generates或apply.tracksnested 超過 16 層的花括號 pattern 以明確錯誤拒絕,不再有 crash 風險。
隨堂測驗
你在 .openspec.yaml 加了 x-jiraKey: PROJ-42,openspec validate --strict 的結果是?
💡 想先看個提示?
只有非 x- 開頭的未辨識 key 才會被回報。
動手升級檢查清單
升級 v1.14.2:動手檢查清單
逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)
延伸閱讀
- 官方 v1.14.2 release notes
- 前一課:
v1140-new-tools-and-archived-changes——十個新工具與 Archived Changes