終結 AI 亂寫 Code!OpenSpec 自動生成規格書,3 步驟讓 AI 乖乖聽話

The Only Bamboo
240 位粉絲
100 觀看·2026年5月24日
你是否曾經遇過請 AI 寫程式,結果它寫出來的跟你的預期完全不同?這不是 AI 不夠聰明,而是我們沒有在實作前「對齊規格」!
這支影片將為你介紹 OpenSpec —— 一款強大的 CLI 工具,幫助你在 AI 寫 Code 之前,先產出雙方都能看懂的規格書(Proposal, Design, Tasks)。我們將完整示範如何使用 Propose、Apply、Archive 三大核心指令,實戰完成一個 Node.js + PostgreSQL 的使用者登入功能。
讓 AI 不再瞎猜,精準實作你的每一個需求!
⏳ **時間軸 (Timestamps):**
00:00 為什麼 AI 總是寫錯你的需求?
00:30 什麼是 OpenSpec?
01:37 OpenSpec 專案結構與核心文件介紹
03:09 核心開發三步驟:Propose, Apply, Archive
04:54 什麼時候最適合使用 OpenSpec?
06:26 安裝與初始化專案 (OpenSpec init)
07:48 實戰演練 (1):使用 Propose 產生規格書
10:44 實戰演練 (2):使用 Apply 自動實作程式碼
11:16 實戰演練 (3):登入功能實際測試
12:23 實戰演練 (4):使用 Archive 封存規格與結語
🔗 **相關資源**
- OpenSpec: https://github.com/Fission-AI/OpenSpec
AI 生成·可能包含錯誤
視頻概述
AI 生成本影片介紹 OpenSpec,一款旨在解決 AI 寫程式時因缺乏明確規格而導致結果與預期不符的 CLI 工具。它要求 AI 在實作前先產出雙方認可的規格書,將需求文件化並保留在專案中,確保開發過程透明且可追溯,避免需求消失在對話紀錄中。
你有沒有遇過這樣子的經驗
叫AI幫你寫功能
他寫出來了跟你想的完全不一樣
或是功能寫好了
兩週後你自己都不知道當初為什麼這樣子做
這個問題並不是AI不夠聰明
而是
AI跟我們之間
從來沒有對過規格要做什麼
今天要介紹的工具叫做
OpenSpec
他讓你在寫任何程式碼之前先讓AI搞
清楚你要什麼
我們平常叫AI寫code
流程大概是這樣
你說幫我做登錄功能
AI就開始寫
但問題在哪裡呢
登錄功能這四個字
你心裡有一個版本
AI心裡有另一個版本
是要用JWT
還是Session
要不要記住登錄狀態
錯誤訊息要怎麼顯示
這一些細節你沒有說
AI就自己猜
猜對了
你很開心
猜錯了
你要花時間改
改完之後
原本的規格在哪裡
不知道
消失在對話記錄裡了
OpenSpec
解決的就是這件事
在你下指令之前
先產出一份雙方都看得懂的規格書
然後AI照著規格做
做完之後規格留在你的專案裡
OpenSpec
是一個CLI的工具
安裝之後會在你的專案裡建一個
OpenSpec資料夾
這個資料夾分兩個部分
第一個是
Specs
你係統現在長什麼樣子
第二個是
Changes
你打算做什麼更動的地方
每一個變更
新增需求
修正bug
都是一個獨立的資料夾
一個Change裡面有幾個文件
Purpose.md
需求目的
Design.md
規劃要怎麼執行
Tasks.md
要做的具體事項
Specs
這次改動影響了哪些規格
這些文件不是你手寫的
是AI根據你的描述自動產生的
你的工作是描述你要什麼
AI的工作是把規格整理清楚之後去實作
OpenSpec的核心工作流程只有三步
第一步
執行Proposal
指令
把你的需求交給AI
AI會自動產生
出四個檔案
說明這次要做什麼
為什麼要做的Proposal.md的檔案
記錄這次影響到的規格變更的
Specs的資料夾
描述技術設計和實作方向的Design.md
的檔案
以及列出具體實作步驟
每一項都有checkbox的
task.md的檔案
第二步檢查這四份資料
確認跟你預期的一樣
有問題就直接跟AI說
修正之後再繼續
沒問題的話
就執行Apply.
AI就會照著
task.md的內容一個一個實作
每一個步驟完成後都會自動打勾
第三步實作完後執行Archive的指令
這次規格會合為OpenSpace的資料夾
下的Specs的資料夾
整個Change的資料夾
會封存到Archive的資料夾
之後隨時查得到這次詳細
需求的計劃
最後講一下
什麼情況下用OpenSpec最有感
功能有一定的複雜度
你怕AI亂猜你的需求
多人合作的專案
規格要讓大家都看得到
你的專案維護了一段時間
想建立一份系統現在是怎麼樣子的活文件
可以不用的時候
真的非常小的改動
比如改一個CSS數值
一次性的script
做完就丟的那種
他不會幫你寫更好的code
他幫你做的是
讓AI動手之前先跟你對好規格
我們把OpenSpec
基本上會用到的功能都介紹完了
接下來要進入安裝與實作部分
不過在開始之前
如果這支影片對你有幫助
請記得幫我點個贊支持一下
還沒有訂閱的朋友
也順手訂閱並開啟小鈴鐺
我會持續分享更多實用的AI功能
不讓你錯過任何的更新
好那我們就開始吧
來我們實際操作看看
首先安裝OpenSpec的程式
裝好之後確認版本
接著進到你的專案目錄
執行初始化
執行OpenSpec
init初始化時
他會問你要設定哪一些AI工具
不管你是用Cloud Code
Cursor還是Codex
都有對應的設定
設定完之後你的專案裡
就多出OpenSpec這個資料夾
而且你的AI工具也會多出
對應的指令或是技能
等等會示範
如果你在你
OpenSpec
下config.yaml
設定你的技術規格
AI出的文件就會更準
等等demo我有加
你們看輸出的差異就知道了
我們要來實作一個使用者登錄功能
應用OpenSpec來管理規格
在執行appose指令之前
我會先跟AI討論這次要做什麼
功能細節是什麼
打算用什麼技術來實作
討論完
再整理成一段提示詞
讓AI產生出規格文件
這次討論完之後
整理出來的提示詞長這樣
請幫我使用note.js實作
Post
Cursor
Login的接口
包含PostgreSQL驗證與
Station cookie機制
資料庫連線長數為Database
URL
並提供一套前端
UI範例與一組Mockuser的測試資料
完整示範從頁面登錄到後端驗證流程
執行之後等AI產出結果
產出完成後
先看Post.md
這份文件說明
這個功能是什麼
為什麼要做
要做到什麼程度
確認AI有沒有理解我的需求
再看
Design.md
這份文件描述技術設計和實作方向
確認跟我一開始想的是不是一樣
有問題的話就直接跟AI說
讓他修正
因為我們這邊是範例
所以設計上沒有太大問題
如果是我自己實作
會先跟AI討論要做什麼
兩份都確認沒問題之後
執行Apply的指令
讓AI照著規格去實作
接下來要來展示
登錄功能是否正常
首先在終端機設定連線自串和Session的密鑰
這兩個環境變數
接著執行建立資料表的指令
再執行建立測試帳號的指令
設定完成後
啟動服務
打開測試的登錄頁面
先測試成功登錄
輸入帳號為Test
密碼為Test12345
送出之後
畫面顯示成功登錄
表示後端驗證通過
Session也已經建立
再測試錯誤密碼的情境
帳號一樣用Test
密碼隨便亂打
畫面顯示失敗
使用者名稱或密碼無效
結果符合預期
最後所有功能實作完之後
不要忘記把這次的需求封存
我們來執行Archive指令
會把這次的Quench資料夾完整的封存
到這邊就是一個完整的
實作流程
這三個指令就是OpenSPEC的核心
工作流程
到這邊OpenSPEC的基本功能
和實作範例都完成了
希望大家都有收穫
如果還不熟悉的
隨時可以回來複習
實作過程中有任何的問題
或對哪個功能有疑惑
歡迎都在留言區
告訴我
我會一一的回覆
如果這支影片
對你有幫助
請記得點贊
訂閱頻道並開啟小鈴鐺
下次有新影片會第一時間通知
旁邊也有我為你精選的
其他的教學影片
有興趣的朋友請點進去看看
我們下一集再見
拜拜
