Theme / v1.12.0

OpenSpec

規格驅動開發

基礎觀念

v1.8:共享 agents 目標與安全歸檔

使用新的 agents 初始化目標、提前驗證 scenario,並在 archive 退役 capability。

建立共享技能目錄

v1.8.0 新增 vendor-neutral 的 agents 工具目標,會將技能寫入共享的 .agents/skills/,供讀取 AGENTS.md 的助理使用。

openspec init --tools agents

這是初始化目標,不會自動同步所有 AI client 的個人目錄;團隊仍要自行決定 .agents/ 是否納入版本控制,以及誰維護其內容。

在寫作階段就防止 scenario 遺失

修改 requirement 時,validate 現在會在 scenario 被刪除時直接失敗並指出要補回的項目。把 openspec validate 放在提案調整後與 archive 前,能在低成本階段發現規格縮減,而不是等到歸檔才處理。

退役已不再存在的 capability

若變更的目的就是移除某 capability 的最後一條 requirement,可在變更宣告 retire_capabilities: true,使 archive 能清理對應 spec。只在程式碼與需求都確定淘汰時使用;若只是暫停實作,保留 spec 比建立空殼更正確。

來源:OpenSpec v1.8.0 release