15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯

作者：Asher同學
日期：2025年11月5日 下午11:09
來源：WeChat 原文

✦整理版優先睇

速讀 5 個重點 高亮

15 分鐘上手輕量 OpenSpec大家好，我是 Asher 同學，今天分享 openspec 這個規格驅動編程（Spec-Driven）的 AI 工具。可工作的知識這個概念是真的迷人，社區現在還有很多類似的方案，比如 spec-kit 。目前發現朋友圈裏玩 AI 的都在玩 openspec，理由就是輕量快速。玩過 spec-kit 的都知道，token 一燒就沒了，而且還慢。最近體驗了一下openspec，快多了。大綱其中主流程是 Step 1，4， 5。Step 0 安裝 (bash)Step 0 初始化項目 (bash)Step 1 陳述需求 (slash command)Step 2 驗證需求格式 (bash)【可選】Step 3 補充和調整需求（對話）Step 4 實現 (slash command)Step 5 存檔修改 (slash command)Step 0 安裝 (bash)一條命令安裝npm install -g @fission-ai/openspec@latestStep 0 初始化項目 (bash)在項目文件夾下面執行：openspec init這個命令主要就是選擇 OpenSpec 配套的 AI 工具，我的 Claude Code 周限了，就選擇codex 了初始化之後會創建下面幾個文件 （核心是@/openspec/AGENTS.md 這個文件）Step 1 陳述需求 (slash command)使用如下的斜槓命令告訴他你要幹什麼：/openspec:proposal Add profile search filters他會把需求分為如下幾類：• ## ADDED Requirements - New capabilities （新增需求）• ## MODIFIED Requirements - Changed behavior（修改需求）• ## REMOVED Requirements - Deprecated features （廢棄需求）這步他主要創建了 3 個文件：1. proposal.md 需求描述文件2. spec.md 規格和驗收條件3. tasks.md 任務列表proposal.md 需求描述文件這個文件描述需求的動機，修改的內容以及影響的範圍。spec.md 規格和驗收條件可以看到這個演示的例子術語新增需求類型（ADDED Requirements）tasks.md 任務列表（後續會動態調整）實現是按照依賴鏈逐次遞進的：1. 後端2. API3. 測試4. UIStep 2 驗證需求格式正確性 (bash)首先是查看，然後拿到名稱進行校驗，最後查看需求openspec listopenspec validate add-profile-search-filtersopenspec show add-profile-search-filters【可選】Step 3 需求校正（直接對話）如果有新的驗收條件需要補充，直接告訴他Can you add acceptance criteria for the role and team filters?Step 4 實現 (slash command)使用如下的斜槓命令實現需求：/openspec:apply add-profile-search-filters首先實現後端和測試然後實現暴露 API然後實現 UI然後 UI 和 API 綁定然後 優化是一個迭代的過程Step 5 存檔修改 (slash command)使用如下的斜槓命令進行歸檔：/openspec:archive 他會幫剛才所有的change 都放到 archive 文件夾下面查看當前完成的規格 (bash)openspec view效果基本的功能都正確，一次過。內容小結本文主要介紹了 OpenSpec 工作的主要流程，目前的感受就是 OpenSpec 很輕量，token 沒有像 spec-kit 那樣直接燒爆。社區目前的聲音是 spec-kit 適合做從 0 到 1 的項目， openspec 更適合從 1到 n。是否正確還有待考證。

整理版摘要

15 分鐘上手輕量 OpenSpec大家好，我是 Asher 同學，今天分享 openspec 呢個規格驅動編程（Spec-Driven）的 AI 工具。可工作的知識呢個概念是真的迷人，社區而家還有很多類似的方案，比如 spec-kit 。目前發現朋友圈裏玩 AI 的都在玩 openspec，理由就是輕量快速。

玩過 spec-kit 的都知道，token 一燒就沒了，而且還慢。最近體驗了一下openspec，快多了。大綱其中主流程是 Step 1，4， 5。Step 0 安裝 (bash)Step 0 初始化項目 (bash)Step 1 陳述需求 (slash command)Step 2 驗證需求格式 (bash)【可選】Step 3 補充和調整需求（對話）Step 4 實現 (slash command)Step 5 存檔修改 (slash command)Step 0 安裝 (bash)一條命令安裝npm install -g @fission-ai/openspec@latestStep 0 初始化項目 (bash)在項目文件夾下面執行：openspec init呢個命令主要就是選擇 OpenSpec 配套的 AI 工具，我的 Claude Code 周限了，就選擇codex 了初始化之後會創建下面幾個文件 （核心是@/openspec/AGENTS.md 呢個文件）Step 1 陳述需求 (slash c…

  • 15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯
  • 15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯｜重點 2
  • 15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯｜重點 3
  • 15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯｜重點 4
  • 15 分鐘上手輕量 OpenSpec，項目一次過，質量不錯｜重點 5
值得記低
流程

可記低 Workflow

15 分鐘上手輕量 OpenSpec大家好，我是 Asher 同學，今天分享 openspec 這個規格驅動編程（Spec-Driven）的 AI 工具。可工作的知識這個概念是真的迷人，社區現在還有很多類似的方案，比如 spec-kit 。…

留作參考
整理重點

整理版

15 分鐘上手輕量 OpenSpec大家好，我是 Asher 同學，今天分享 openspec 呢個規格驅動編程（Spec-Driven）的 AI 工具。可工作的知識呢個概念是真的迷人，社區而家還有很多類似的方案，比如 spec-kit 。目前發現朋友圈裏玩 AI 的都在玩 openspec，理由就是輕量快速。玩過 spec-kit 的都知道，token 一燒就沒了，而且還慢。最近體驗了一下openspec，快多了。大綱其中主流程是 Step 1，4， 5。Step 0 安裝 (bash)Step 0 初始化項目 (bash)Step 1 陳述需求 (slash command)Step 2 驗證需求格式 (bash)【可選】Step 3 補充和調整需求（對話）Step 4 實現 (slash command)Step 5 存檔修改 (slash command)Step 0 安裝 (bash)一條命令安裝npm install -g @fission-ai/openspec@latestStep 0 初始化項目 (bash)在項目文件夾下面執行：openspec init呢個命令主要就是選擇 OpenSpec 配套的 AI 工具，我的 Claude Code 周限了，就選擇codex 了初始化之後會創建下面幾個文件 （核心是@/openspec/AGENTS.md 呢個文件）Step 1 陳述需求 (slash command)使用如下的斜槓命令告訴他你要幹什麼：/openspec:proposal Add profile search filters他會把需求分為如下幾類：• ## ADDED Requirements - New capabilities （新增需求）• ## MODIFIED Requirements - Changed behavior（修改需求）• ## REMOVED Requirements - Deprecated features （廢棄需求）這步他主要創建了 3 個文件：1. proposal.md 需求描述文件2. spec.md 規格和驗收條件3. tasks.md 任務列表proposal.md 需求描述文件呢個文件描述需求的動機，修改的內容同埋影響的範圍。spec.md 規格和驗收條件可以看到呢個演示的例子術語新增需求類型（ADDED Requirements）tasks.md 任務列表（後續會動態調整）實現是按照依賴鏈逐次遞進的：1. 後端2. API3. 測試4. UIStep 2 驗證需求格式正確性 (bash)首先是查看，然後拿到名稱進行校驗，最後查看需求openspec listopenspec validate add-profile-search-filtersopenspec show add-profile-search-filters【可選】Step 3 需求校正（直接對話）如果有新的驗收條件需要補充，直接告訴他Can you add acceptance criteria for the role and team filters?Step 4 實現 (slash command)使用如下的斜槓命令實現需求：/openspec:apply add-profile-search-filters首先實現後端和測試然後實現暴露 API然後實現 UI然後 UI 和 API 綁定然後 優化是一個迭代的過程Step 5 存檔修改 (slash command)使用如下的斜槓命令進行歸檔：/openspec:archive 他會幫剛才所有的change 都放到 archive 文件夾下面查看當前完成的規格 (bash)openspec view效果基本的功能都正確，一次過。內容小結本文主要介紹了 OpenSpec 工作的主要流程，目前的感受就是 OpenSpec 很輕量，token 沒有像 spec-kit 嗰樣直接燒爆。社區目前的聲音是 spec-kit 適合做從 0 到 1 的項目， openspec 更適合從 1到 n。是否正確還有待考證。

 

15 分鐘上手輕量 OpenSpec

大家好，我係 Asher 同學，今日分享 openspec 呢個規格驅動程式開發（Spec-Driven）嘅 AI 工具。

可工作嘅知識呢個概念真係好吸引，社區而家仲有好多類似方案，例如 spec-kit。

而家見到朋友圈入面玩 AI 嘅都喺度玩 openspec，原因係輕便又快。

玩過 spec-kit 嘅都知道，token 一燒就冇曬，而且仲慢。

最近試咗下 openspec，快好多。

大綱

當中主要流程係 Step 1、4、5。


Step 0 安裝 (bash)

Step 0 初始化項目 (bash)

Step 1 陳述需求 (slash command)

Step 2 驗證需求格式 (bash)

【可選】Step 3 補充同調整需求（對話）

Step 4 實現 (slash command)

Step 5 存檔修改 (slash command)

image-20251105224440300

Step 0 安裝 (bash)

一條 command 就裝到

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

Step 0 初始化項目 (bash)

喺項目 folder 入面執行：

openspec init

呢個 command 主要係揀 OpenSpec 配套嘅 AI 工具，我嘅 Claude Code 限額用曬，就揀咗 codex。

image-20251105220418344
image-20251105220517829
image-20251105220955264

初始化之後會建立以下幾個檔案（核心係 @/openspec/AGENTS.md 呢個檔案）

image-20251105221125380

Step 1 陳述需求 (slash command)

用以下嘅斜槓命令話佢知你要做乜：

/openspec:proposal Add profile search filters

佢會將需求分為以下幾類：

  • • ## ADDED Requirements - New capabilities（新增需求）
  • • ## MODIFIED Requirements - Changed behavior（修改需求）
  • • ## REMOVED Requirements - Deprecated features（廢棄需求）

呢步佢主要建立咗 3 個檔案：

  1. 1. proposal.md 需求描述檔案
  2. 2. spec.md 規格同驗收條件
  3. 3. tasks.md 任務列表

proposal.md 需求描述檔案

呢個檔案描述需求嘅動機、修改嘅內容同影響嘅範圍。

image-20251105110338993

spec.md 規格同驗收條件

可以見到呢個示範例子嘅術語係新增需求類型（ADDED Requirements）

image-20251105110433958

tasks.md 任務列表（後續會動態調整）

實現係按照依賴鏈逐個遞進嘅：

  1. 1. 後端
  2. 2. API
  3. 3. 測試
  4. 4. UI
image-20251105110531957

Step 2 驗證需求格式係咪正確 (bash)

首先係查看，

然後拎個名嚟校驗，

最後查看需求。

openspec list
openspec validate add-profile-search-filters
openspec show add-profile-search-filters
image-20251105111525356

【可選】Step 3 需求校正（直接對話）

如果有新嘅驗收條件要補充，直接話佢知。

Can you add acceptance criteria for the role and team filters?
image-20251105111832294

Step 4 實現 (slash command)

用以下嘅斜槓命令實現需求：

/openspec:apply add-profile-search-filters

首先實現後端同測試

image-20251105112735974

然後實現暴露 API

然後實現 UI

然後 UI 同 API 綁定

然後優化

係一個疊代嘅過程

Step 5 存檔修改 (slash command)

用以下嘅斜槓命令進行歸檔：

/openspec:archive 

佢會將先前所有 change 都放去 archive folder 下面

image-20251105115836900
image-20251105115912899

睇下當前完成嘅規格 (bash)

openspec view
image-20251105123136308

效果

基本功能都正確，一次過搞掂。

image-20251105120222524

內容總結

呢篇文章主要介紹咗 OpenSpec 工作嘅主要流程，而家嘅感覺係 OpenSpec 好輕量，token 冇好似 spec-kit 咁直接燒爆。

社區而家嘅講法係 spec-kit 適合做由 0 到 1 嘅項目，openspec 更適合由 1 到 n。

係咪正確仲有待考證。

 


 

15 分鐘上手輕量 OpenSpec

大家好，我是 Asher 同學，今天分享 openspec 這個規格驅動編程（Spec-Driven）的 AI 工具。

可工作的知識這個概念是真的迷人，社區現在還有很多類似的方案，比如 spec-kit 。

目前發現朋友圈裏玩 AI 的都在玩 openspec，理由就是輕量快速。

玩過 spec-kit 的都知道，token 一燒就沒了，而且還慢。

最近體驗了一下openspec，快多了。

大綱

其中主流程是 Step 1，4， 5。


Step 0 安裝 (bash)

Step 0 初始化項目  (bash)

Step 1  陳述需求  (slash command)

Step 2  驗證需求格式  (bash)

【可選】Step 3  補充和調整需求（對話）

Step 4  實現 (slash command)

Step 5  存檔修改 (slash command)

image-20251105224440300

Step 0 安裝 (bash)

一條命令安裝

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

Step 0 初始化項目  (bash)

在項目文件夾下面執行：

openspec init

這個命令主要就是選擇 OpenSpec 配套的 AI 工具，我的 Claude Code 周限了，就選擇codex 了

image-20251105220418344
image-20251105220517829
image-20251105220955264

初始化之後會創建下面幾個文件 （核心是@/openspec/AGENTS.md 這個文件）

image-20251105221125380

Step 1  陳述需求  (slash command)

使用如下的斜槓命令告訴他你要幹什麼：

/openspec:proposal Add profile search filters

他會把需求分為如下幾類：

  • • ## ADDED Requirements - New capabilities （新增需求）
  • • ## MODIFIED Requirements - Changed behavior（修改需求）
  • • ## REMOVED Requirements - Deprecated features （廢棄需求）

這步他主要創建了 3 個文件：

  1. 1. proposal.md 需求描述文件
  2. 2. spec.md 規格和驗收條件
  3. 3. tasks.md 任務列表

proposal.md 需求描述文件

這個文件描述需求的動機，修改的內容以及影響的範圍。

image-20251105110338993

spec.md  規格和驗收條件

可以看到這個演示的例子術語新增需求類型（ADDED Requirements）

image-20251105110433958

tasks.md 任務列表（後續會動態調整）

實現是按照依賴鏈逐次遞進的：

  1. 1. 後端
  2. 2. API
  3. 3. 測試
  4. 4. UI
image-20251105110531957

Step 2  驗證需求格式正確性  (bash)

首先是查看，

然後拿到名稱進行校驗，

最後查看需求

openspec list
openspec validate add-profile-search-filters
openspec show add-profile-search-filters
image-20251105111525356

【可選】Step 3  需求校正（直接對話）

如果有新的驗收條件需要補充，直接告訴他

Can you add acceptance criteria for the role and team filters?
image-20251105111832294

Step 4 實現 (slash command)

使用如下的斜槓命令實現需求：

/openspec:apply add-profile-search-filters

首先實現後端和測試

image-20251105112735974

然後實現暴露 API

然後實現 UI

然後 UI 和 API 綁定

然後 優化

是一個迭代的過程

Step 5 存檔修改 (slash command)

使用如下的斜槓命令進行歸檔：

/openspec:archive 

他會幫剛才所有的change 都放到 archive 文件夾下面

image-20251105115836900
image-20251105115912899

查看當前完成的規格 (bash)

openspec view
image-20251105123136308

效果

基本的功能都正確，一次過。

image-20251105120222524

內容小結

本文主要介紹了 OpenSpec 工作的主要流程，目前的感受就是 OpenSpec 很輕量，token 沒有像 spec-kit 那樣直接燒爆。

社區目前的聲音是 spec-kit 適合做從 0 到 1 的項目， openspec 更適合從 1到 n。

是否正確還有待考證。