OpenSpec 入門課：5 篇文章帶你搞懂 AI 開發的規格管理

很多人用 AI 寫程式的方式是：打一句「幫我加這個功能」，然後等代理生出一堆程式碼，看起來好像沒問題，跑起來才發現走偏了——改三次還在原地。問題不是 AI 不夠聰明，而是根本沒有人把「要做什麼」說清楚。OpenSpec 就是在解這件事。

為什麼這個系列值得讀

OpenSpec 不是另一套規格撰寫格式，它更像是一條工作節奏：先說清楚要做什麼，再讓 AI 動手。聽起來很簡單，實際上大多數人跳過了這一步，然後才在修改階段付出三倍代價。這個系列把整條流程拆成五篇，從「為什麼要這樣做」到「怎麼實際跑一輪」，每篇聚焦一個主題，讀完有套可以重複用的套路。

這個系列適合誰

常叫 AI 寫程式，但結果不穩定、常常要改很多遍的人
已經知道「要寫需求文件」，但不知道怎麼讓 AI 配合它的人
想在個人專案或小團隊裡，把 AI 開發流程跑得更順的人

系列閱讀地圖

整條路線可以想成：先懂痛點 → 裝好工具 → 搞清楚核心概念 → 跑完一輪流程 → 看真實場景怎麼用。五篇文章各是一站，建議順序讀，不過每篇本身也可以獨立跳入。

5 篇文章你會學到什麼

為什麼沒有 spec 的 AI 開發最終都很貴
導讀： 從「AI 很努力但結果不穩」這個熟悉的慘狀切入，說明 OpenSpec 在解什麼問題，為什麼它的設計是「流動而非剛性」。讀完你會知道這條路值不值得走。
OpenSpec 安裝與初始化：5 分鐘讓專案開始有規格
導讀： 動手裝好、初始化、看懂目錄結構。這篇是純操作，讀完你的專案就有 OpenSpec 可以用了。
specs、changes、artifacts：OpenSpec 三個核心概念
導讀： 搞清楚這三個東西各自是什麼、為什麼要分開。沒搞懂這篇，後面的指令你會用但不會懂為什麼要這樣用。
/opsx:propose → apply → archive：跑完一輪完整的 OpenSpec 流程
導讀： 帶你走完從「有個想法」到「實作完成、規格歸檔」的完整流程，每個指令做了什麼都說清楚。
真實場景怎麼用：新功能、修 bug、舊專案加入 OpenSpec
導讀： 把前四篇學到的東西對應到日常任務，新功能、bug 修復、舊專案加入 OpenSpec 各有一套對應套路。

建議閱讀順序

建議照 1 → 2 → 3 → 4 → 5 讀。第一篇先建立動機，第二篇裝好工具，第三篇搞懂概念，第四篇實際跑一輪，第五篇對應到真實工作。如果時間有限，至少讀 1 和 4，就能掌握最核心的「為什麼」和「怎麼用」；有餘力再補 3 把概念補齊。

快速上手版本

一句話：想新增或修改功能，先 /opsx:propose，讓 AI 生成 spec + 設計 + 任務清單，確認沒問題再 /opsx:apply 實作，完成後 /opsx:archive 歸檔。 不跳過這條流程，AI 亂跑偏的機率會直接掉很多。細節交給上面五篇；這篇的任務：認路、排程、出發。