Original project: https://github.com/Fission-AI/OpenSpec.git

License: MIT Copyright (c) 2024 OpenSpec Contributors

→ fluid not rigid
→ iterative not waterfall
→ easy not complex
→ built for brownfield not just greenfield
→ scalable from personal projects to enterprises

追蹤 X 上的 @0xTab 取得更新 · 加入 OpenSpec Discord 尋求協助與提問。

在團隊中使用 OpenSpec？ 在此寄送電子郵件 存取我們的 Slack 頻道。

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

**需要 Node.js 20.19.0 或更高版本。 **

全域安裝OpenSpec：

npm install -g @fission-ai/openspec@latest

然後導航到您的專案目錄並初始化：

cd your-project
openspec init

現在告訴你的人工智慧： /opsx:propose <what-you-want-to-build>

如果您想要擴充工作流程（/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard），選擇它 openspec config profile 並執行 openspec update.

→ 入門：第一步
→ 工作流程：組合和圖案
→ 命令：斜線指令與技能
→ CLI：終端參考
→ 支援的工具：工具整合和安裝路徑
→ 概念：整體如何銜接
→ Multi-Language：多語言支援
→ 客製化：讓它成為你的

當需求僅存在於聊天歷史記錄中時，人工智能編碼輔助功能強大，但不可預測。 OpenSpec 新增了一個輕量級規範層，以便您在編寫任何程式碼之前必須建立的內容達成一致。

• 建構之前達成一致——人類和人工智慧在編寫程式碼之前就規範進行協調
• 保持井井有條 - 每個變更都有自己的資料夾，其中包含提案、規格、設計和任務
• 工作流程靈活 - 隨時更新任何工件，沒有嚴格的階段門
• 使用你的工具 - 透過斜槓命令與 20 多個人工智慧助理一起工作

與。 Spec Kit (GitHub) — 垂直但級。剛性鄰接門，大量Markdown，Python設定。 OpenSpec可以重量更輕，讓你自由迭代。

與。 Kiro (AWS) — 功能強大，但您被鎖定在他們的 IDE 中並僅限於 Claude 模型。 OpenSpec 可與您已使用的工具搭配使用。

與。什麼都沒有——沒有規範的人工智能編碼意味著模糊的提示和不可預測的結果。 OpenSpec儀式可以帶來可預測性。

升級包

npm install -g @fission-ai/openspec@latest

重新整理代理說明

在每個專案中執行此命令以重新產生 AI 指導並確保最新的斜線命令某個活動狀態：

openspec update

模型選擇：OpenSpec最適合高推理模型。我們建議Opus 4.5 和 GPT 5.2 進行規劃和實施。

上下文衛生：OpenSpec 受益於乾淨的上下文視窗。在開始實施之前清除您的上下文，並在整個會話過程中保持良好的上下文衛生。

小修復 — Bug修復、拼字錯誤更正和小可以作為改進直接PR提交。

較大變更 — 對於新功能、重大重構或架構變更，請先提交 OpenSpec 變更提案，以便我們在實施開始之前就意圖和目標保持一致。

在撰寫提案時，請牢記 OpenSpec 理念：我們為不同的編碼代理、模型和用例的廣泛用戶提供服務。改變應該對每個人都有好處。

歡迎人工智能產生的方案代碼——只要經過測試和驗證。包含AI產生方案代碼的PR應提及所使用的方案代碼代理和模型（例如，“使用claude-opus-4-5-20251101 Claude使用方案代碼產生”）。

• 安裝依賴項： pnpm install
• 建造： pnpm run build
• 測試： pnpm test
• 本地開發CLI： pnpm run dev 或者 pnpm run dev:cli
• 常規提交（一行）： type(scope): subject

MIT