OpenSpec 怎麼用？從安裝到第一個專案，一步步帶你做

先給你一句答案：OpenSpec 是一個「規格驅動開發」工具，讓你在叫 AI 寫程式之前，先把計畫（要做什麼、分哪些步驟）寫成文件、確認了再動手。 這篇帶你從零安裝、跑完第一輪。

為什麼要這樣做，我在先寫計畫，再叫 AI 動手那篇講過——這篇專講「工具怎麼裝、怎麼用」。

開始前，先準備兩樣東西

• Node.js（版本 20.19 以上）：你可以把它想成「跑這類工具的引擎」。還沒裝的話，先去 Node.js 官網裝好。
• 一個專案資料夾：拿你想練習的專案就行。

第一步：安裝 OpenSpec

打開終端機（就是打指令的那個視窗），貼上這行：

npm install -g @fission-ai/openspec

-g 是「全域安裝」，裝一次，之後每個專案都能用。

第二步：在專案裡初始化

切到你的專案資料夾，執行：

openspec init --tools claude

--tools claude 是告訴它「我用 Claude」；你也可以換成 cursor，或用 --tools all 一次設定好。跑完它會幫你把 OpenSpec 需要的資料夾建好。

第三步：開一個「change」（也就是你的計畫）

每次要做一件比較大的事，就開一個 change：

openspec new change add-login

add-login 是這次計畫的名字（自己取）。接著照它的指引，把這次的**提案（proposal）和任務清單（tasks）**寫好——這就是你跟 AI 的「設計圖」。

第四步：檢查計畫有沒有寫對

openspec validate --all

它會幫你檢查計畫格式有沒有問題。沒問題，就讓 AI 照任務清單一項一項做、一項一項打勾。

第五步：做完了，歸檔

整個 change 完成後：

openspec archive add-login

它會把這次的計畫收進封存，專案就乾淨地進到下一輪。

常用指令小抄

• openspec list：看目前有哪些計畫
• openspec status --change <名字>：看某個計畫做到哪
• openspec show <名字>：看計畫的細節

一句話總結

OpenSpec 不難，核心就五步：裝 → init → 開 change → validate → archive。難的從來不是指令，是養成「先寫計畫再動手」的習慣。

參考來源

• OpenSpec 官方網站open_in_new
• OpenSpec CLI 文件（GitHub）open_in_new