跳到主內容

Theme / v1.16.0

OpenSpec

規格驅動開發

基礎觀念

v1.14.2:x- 擴充鍵、更快的 Tab 與誠實的 Verify

🟡 中階|掌握 OpenSpec v1.14.2 的重點:.openspec.yaml 的 x- 前綴擴充鍵(自己的 metadata 不再讓 --strict 失敗)、Tab completion 載入 48 模組、delta 文字歸檔遺漏警告、REMOVED requirement 的誠實驗證與 symlink 支援。含互動測驗與檢查清單。

概述

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.tracks nested 超過 16 層的花括號 pattern 以明確錯誤拒絕,不再有 crash 風險。

隨堂測驗

隨堂測驗

你在 .openspec.yaml 加了 x-jiraKey: PROJ-42,openspec validate --strict 的結果是?

💡 想先看個提示?

只有非 x- 開頭的未辨識 key 才會被回報。

動手升級檢查清單

升級 v1.14.2:動手檢查清單

逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)

0 / 4

延伸閱讀