系列文章: Openspec (3/6)
OpenSpec 安裝與初始化：5 分鐘讓專案開始有規格
這篇純動手，不講大道理——裝好、初始化、看懂目錄，你就可以繼續往下走了。
前置條件
需要 Node.js 20.19.0 以上版本。確認一下：
node --version版本夠了就繼續，不夠就先升級 Node.js。
安裝 OpenSpec
全域安裝：
npm install -g @fission-ai/openspec@latest或者如果你用 pnpm / yarn / bun：
pnpm add -g @fission-ai/openspec@latest
yarn global add @fission-ai/openspec@latest
bun add -g @fission-ai/openspec@latest裝完確認一下：
openspec --version有輸出版本號就成功了。
初始化專案
進到你的專案目錄：
cd your-project
openspec init完成後，你的專案裡會多一個 openspec/ 資料夾。
目錄結構長什麼樣
openspec/
├── specs/ # 你的系統現在長什麼樣（真相來源）
│ └── <domain>/
│ └── spec.md
├── changes/ # 每個待實作的修改（一個改動一個資料夾）
│ └── <change-name>/
│ ├── proposal.md
│ ├── design.md
│ ├── tasks.md
│ └── specs/ # 這次修改的 delta spec
│ └── <domain>/
│ └── spec.md
└── config.yaml # 專案設定（可選）
兩個核心目錄：
specs/ 是你系統的現況文件——描述系統目前的行為，按 domain 分資料夾組織。你可以按功能區（auth/、payments/）、按元件（api/、frontend/）、或按業務邊界來切，看你的專案怎麼組織就怎麼切。
changes/ 是還在進行中的修改——每一個想新增或修改的功能，都有自己的資料夾，裡面放著 proposal、設計、任務清單、還有這次修改的 delta spec。做完之後 archive，delta spec 就會合併回 specs/。
開始告訴 AI 使用 OpenSpec
初始化好之後，去你的 AI assistant（Cursor、Claude Code、Windsurf 等）的對話，輸入：
/opsx:propose <你想做的事情>
例如：
/opsx:propose add-dark-mode
AI 就會開始替你建立這次修改的規格資料夾和相關 artifact。
不知道 /opsx:propose 做了什麼？下一篇先說清楚核心概念，再來談完整流程。
如果想啟用進階工作流
預設安裝的是 core profile，包含四個基本指令（propose、explore、apply、archive）。如果你想用更完整的 /opsx:new、/opsx:ff、/opsx:verify 等指令，可以切換 profile：
openspec config profile選好 profile 之後，在專案裡執行：
openspec update這樣 AI 就會收到更新過的指令說明，新的 slash command 就可以用了。
讓 OpenSpec 保持最新
OpenSpec 有在持續更新，定期執行下面兩個指令確保你在用最新版：
npm install -g @fission-ai/openspec@latest # 升級套件
openspec update # 更新 AI 指令說明環境裝好了，下一篇把 specs、changes、artifacts 這三個核心概念說清楚——搞懂這三個，你才會知道每個指令背後在做什麼。