用途
用 AI 開發時，需求容易散落在聊天紀錄裡：這次說好要保留的行為，下次修改時可能被忽略。OpenSpec 把需求、設計與待辦整理成專案裡的文件，讓你先看過計畫，再請 AI 實作。
它是一套結合 CLI 與多個 agent skills 的規格驅動開發工具。你可以在原本的 AI 開發工具裡使用它，不必為了這套流程換編輯器。官方專案提供原始碼，採 MIT 授權。
適用情境
如果一個功能需要反覆討論、跨好幾次對話，或有明確的驗收條件，我們認為 OpenSpec 值得試試。需求留在專案裡，下次接著做時，就有文件可以對照。
只改一句文案時，建立完整變更文件可能比直接修改更費事；是否使用這套流程，可依改動大小決定。
以上是編者對使用情境的判斷。本文依官方文件整理，沒有加入個人實測心得或效能比較。
使用範例
以新增一個 Skills 專區為例，可以先對 AI 說：
幫我探索 Skills 專區要怎麼做。我想收錄自製與外部精選的 skills，能按分類篩選、按時間排序。先釐清需求，暫時不要寫程式。
官方入門流程會把一次變更分成以下幾個環節：
- 探索：和 AI 討論需求、查看現有程式、比較做法，這時不寫程式。
- 提案：整理變更目的、需求情境與任務清單；需要技術決策時，再加入設計文件。
- 人工審閱：確認範圍與驗收條件，趁還沒實作時修正計畫。
- 實作：請 AI 依照文件逐項完成任務。
- 歸檔：把完成的需求更新到主要規格，留下這次變更的紀錄。
如果直接呼叫探索功能，Codex 使用 $openspec-explore，Claude Code 的命令形式則是 /opsx:explore。各工具的呼叫方式不同，請以初始化時顯示的提示及支援工具文件為準。
限制
規格仍然需要人檢查。需求如果寫錯，整理成文件後還是會錯；OpenSpec 不能保證 AI 不出錯，也不能代替程式測試與人工審閱。
支援平台、安裝方式與命令可能隨版本調整。本文列出 Codex、Claude Code、Cursor 與 GitHub Copilot 作為例子，完整清單請查看官方文件。
安裝方式
以下示範 npm 安裝，先確認電腦有 Node.js 22.12.0 以上。在終端機執行：
npm install -g @fission-ai/openspec@latest
openspec --version出現版本號後，進入你想使用的專案資料夾，再初始化：
cd your-project
openspec init把 your-project 換成自己的專案路徑，依提示選擇使用的 AI 工具。之後就能在該工具的對話裡，請 AI 探索需求或建立變更提案。
官方也提供獨立執行檔與 Homebrew 等方式；獨立執行檔不需要 Node.js。其他安裝選項與更新步驟見官方安裝說明。