規格驅動開發 · Spec-Driven Development

讓 AI
規格
寫程式

OpenSpec 在你和 AI 動手寫程式之前,先建立輕量的規格文件層, 讓需求不再只存在於聊天記錄中。

37,700+ GitHub Stars
25+ 支援 AI 工具
MIT 完全開源
npm install -g @fission-ai/openspec@latest Node.js 20.19.0+
標準工作流程
# 1. 一鍵建立所有規格文件
你: /opsx:propose add-oauth-login
AI:建立規格、設計文件、任務清單

# 2. 審查後執行實作
你: /opsx:apply
✓ 1.1 建立 OAuth provider 設定
✓ 1.2 新增 callback endpoint
✓ 2.1 更新登入 UI 元件

# 3. 歸檔,規格永久保存
你: /opsx:archive
✓ 已歸檔並更新規格庫

為什麼選 OpenSpec?

專為 AI 協作開發設計,解決 AI 程式碼助理最常見的失控問題。

規格文件層

在程式碼庫中建立輕量的 openspec/ 目錄, 以 Markdown 規格文件定義需求,隨 Git 版本管理, 可與團隊共同審查。

25+ AI 工具整合

原生支援 Claude Code、Cursor、Windsurf、GitHub Copilot、 Gemini CLI 等 25 個以上的 AI 助理,一次安裝,全面覆蓋。

迭代工作流程

流動而非瀑布式。Propose → Apply → Archive 三步驟循環, 規格隨時可修改,AI 按最新規格實作,結果可預測。

現有專案適用

專為 Brownfield 設計,無需從頭重構。規格隨功能開發 逐步建立,零遷移成本,個人或企業均可使用。

斜線命令參考

在任何支援的 AI 助理中直接輸入斜線命令即可啟動工作流程。

核心命令(預設安裝)
/opsx:propose 一鍵建立所有規格文件(proposal、specs、design、tasks),最常用的命令。
/opsx:explore 在提案之前自由探索問題,AI 分析程式碼庫後提供有根據的建議,不承諾任何實作。
/opsx:apply 讓 AI 根據 tasks.md 逐步實作所有任務,自動打勾追蹤進度。
/opsx:archive 將完成的變更規格合併進主規格庫,移至歸檔區並加上日期前綴。
擴展命令(需手動啟用)
/opsx:new 只建立變更資料夾與元資料,不產生內容文件。
/opsx:continue 依依賴順序逐步建立下一份規格文件,每次一個。
/opsx:ff 快速前進,一次建立所有尚未完成的規格文件。
/opsx:verify 驗證實作是否符合規格,歸檔前的品質把關。
/opsx:sync 將 Delta 規格合併進主規格庫,但不歸檔變更本身。
/opsx:bulk-archive 一次歸檔多個已完成的變更。
/opsx:onboard 使用你實際的程式碼庫進行 15 分鐘的引導式教學。

啟用擴展命令:執行 openspec config profile 選擇設定檔,再執行 openspec update 套用。

三步驟完成一個功能

從模糊需求到可追蹤的規格,再到可預測的實作結果。

01

提案

/opsx:propose add-feature

AI 分析你的需求,自動建立 proposal.md、specs/、design.md、tasks.md 四份文件。你審查確認後才進入實作。

02

實作

/opsx:apply

AI 根據 tasks.md 逐一完成任務並打勾追蹤, 遇到問題會停下來詢問你,不會自作主張偏離規格。

03

歸檔

/opsx:archive

將 Delta 規格合併進主規格庫 openspec/specs/, 形成永久的活文件,作為下一次開發的基礎。

完整工作流程示範
# 步驟 1:提案(AI 自動產生所有規格文件)
你:/opsx:propose add-user-notifications
AI:Created openspec/changes/add-user-notifications/
    ✓ proposal.md   ✓ specs/   ✓ design.md   ✓ tasks.md
# 步驟 2:審查文件(你負責這步)
# 步驟 3:實作(AI 按任務清單執行)
你:/opsx:apply
    ✓ 1.1 Create notification model
    ✓ 1.2 Add notification API endpoints
    ✓ 2.1 Create NotificationBell component
    ✓ All 4 tasks complete!
# 步驟 4:歸檔
你:/opsx:archive
    ✓ Merged specs into openspec/specs/notifications/spec.md
    ✓ Archived change — Ready for next feature!

與其他方案的比較

OpenSpec 在靈活性與支援廣度上領先同類工具。

比較項目 OpenSpec Spec Kit (GitHub) Kiro (AWS)
設定複雜度 低(npm 一行安裝) 高(Python 環境)
工作流彈性 高(流動式) 低(嚴格階段)
AI 工具支援數 25+ 個工具 有限 僅自家 IDE
AI 模型限制 無限制 無限制 限 Claude
規格儲存位置 程式碼庫中 程式碼庫中 IDE 內
開源授權 MIT 開源 閉源
離線支援
自訂 Schema