初識Spec Kit

大家好，我係小溪，見字如面。隨住AI編程嘅快速發展，喺軟件開發入面，SDD (Spec-Driven Development)規範驅動開發 正成為一種趨勢，市面上都逐漸湧現出啲優秀嘅SDD框架同工具，今日要認識嘅Spec Kit就係由GitHub官方推出嘅開源工具包，佢專門用嚟實現規格驅動開發，旨在改變開發者同AI編碼助手嘅協作方式。

目前用緊嘅版本

specify-cli v0.0.22

優勢

• 支援 Linux、macOS、Windows系統

• 開源免費

• 適用於 0→1 的項目

• 多平台支援

限制

• Spec Kit依賴 UV 和 Python環境

• 需要對Spec Kit嘅使用有一定嘅瞭解

• 生成嘅文檔預設都係英文嘅，需要一定嘅英文閲讀能力

簡介

Spec Kit 係GitHub官方開源嘅 規範驅動開發（SDD，全稱Spec-Driven Development） 工具包，佢引入咗 規範驅動開發 嘅新型軟件開發模式，透過「規範→計劃→任務→實現」嘅結構化流程，建立系統化嘅開發工作流程，從而提升代碼質量同開發效率。

Github地址：https://github.com/github/spec-kit

工作流程

Spec Kit提供咗以下核心命令：

• /speckit.constitution：制定或更新項目級嘅開發原則同指南，喺項目初始化或引入新規範時使用

• /speckit.specify：明確需求範圍同用戶故事，喺開始新功能開發時使用

• /speckit.clarify(可選)：澄清需求入面嘅模糊領域，喺制定計劃前使用

• /speckit.plan：基於技術棧建立實施方案，喺需求明確之後使用

• /speckit.tasks：生成可執行嘅任務清單，喺方案確定之後使用

• /speckit.analyze(可選)：跨工件一致性同覆蓋率分析，喺任務生成之後、實施之前使用

• /speckit.checklist(可選)：生成質量檢查清單，喺需求驗證階段使用

• /speckit.implement：按計劃執行所有開發任務，喺任務分解完成之後使用

安裝配置

前置條件

• UV包管理工具

• Python 3.11或以上版本

安裝

Spec Kit安裝依賴UV包管理工具，喺安裝前需要先安裝UV，對UV仲未了解嘅朋友可以睇返往期內容：【Python】Python版本、項目、包、管理工具UV

$ uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

安裝完成之後，喺命令行終端輸入 specify version，輸出版本信息即係代表安裝成功

更新Spec Kit可以用UV

$ uv tool upgrade specify-cli

都可以用以下命令更新

$ uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

一次性使用

如果只係一次過使用可以用uvx允許，原理類似npx

$ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

基本使用

平台支援

Spec Kit支援多種平台同CLI工具

使用唔同嘅平台，需要用 --ai 進行指定，平台對應嘅AI助手類型：

• claude

• gemini

• copilot

• cursor-agent

• qwen

• opencode

• codex

• windsurf

• kilocode

• auggie

• roo

• codebuddy

• amp

• shai

• q

• bob

命令行指令

Spec Kit提供咗命令指令，喺命令行終端輸入 specify --help 可以查看幫助文檔

• init：從最新模板初始化一個新嘅Specify項目

• check：檢查所有必需嘅工具係咪已經安裝

• version：顯示版本同系統信息

輸入  specify check  可以對使用環境進行檢查

Spec Kit目錄結構

Spec Kit嚴格按照目錄結構進行管理，一個完整嘅Spec Kit目錄結構大致如下：

.specify
└── memory/                        # 記憶文件
│  ├── constitution.md
└── scripts/                       # spec kit依賴的腳本
│  └── bash/
│    ├── check-prerequisites.sh
│    ├── common.sh
│    ├── create-new-feature.sh
│    ├── setup-plan.sh
│    ├── update-agent-context.sh
└── templates/                     # spec kit命令模版
│  ├── agent-file-template.md
│  ├── checklist-template.md
│  ├── plan-template.md
│  ├── spec-template.md
│  └── tasks-template.md
└── specs/                        # 需求變更
│ └── 001-local-task-manager/
│  └── checklists/               #檢查項 
│    ├── requirements.md
│  └── spec.md                   # 需求規範說明

初始化項目

Spec Kit支援 新項目 和 現有項目 兩種初始化方式：

1）新項目初始化

呢個方式適合由零開始嘅新項目，直接喺命令行終端輸入以下指令：

# 手動選擇AI助手類型
$ specify init <項目名稱>

# 指定AI助手類型
$ specify init <項目名稱> --ai <AI助手類型>

以預設手動選擇AI助手類型配置為例，喺命令行終端輸入 specify init my-test 會提示我哋先選擇AI助手

撳Enter進入第二步，選擇終端類型，提供咗 sh 和 ps 兩種類型（macOS、Linux揀sh，Windows揀ps就得）

撳Enter進入下一步，Spec Kit會根據我哋嘅配置完成初始化，初始化完成之後會俾出使用Spec Kit嘅關鍵步驟

Spec Kit會用內置模版 建立項目、生成AI助手自定義命令、生成Spec Kit目錄結構

喺交互式命令中輸入 /speckit 就可以睇到所有自定義指令

2）現有項目初始化

呢個方式適合已有項目嘅初始化，入去項目根目錄，直接喺命令行終端輸入以下指令，步驟同新項目初始化一致

# 手動選擇AI助手類型
$ specify init .

# 指定AI助手類型
$ specify init . --ai claude

# 使用--here標識，指定AI助手類型
$ specify init --here --ai claude

制定項目原則（constitution）

定義項目嘅 最高準則（例如團隊約定、技術邊界、代碼質量等），確保AI生成嘅所有內容符合團隊規範，為後續所有規格、計劃、任務提供指導

/speckit.constitution 
1.項目原則
- 後端接口全部使用Nextjs的API Route，前端調用後端接口
- 使用淺色主題，頁面簡潔、美觀
2.技術約定
- 優先使用原生Web API，避免引入非必要的三方庫
- 保持代碼清晰易讀，不要過度優化
- UI 響應時間保持在100ms以內

執行完成之後，Spec Kit會更新 .specify/memory/constitution.md 文件記錄上面嘅原則同約定，目前Spec Kit預設輸出嘅係英文版文檔，如果需要中文版本就需要手動翻譯

定義功能需求（specify）

透過自然語言描述需要實現嘅功能需求，唔需要包含詳細嘅技術實現部分，可以包含 項目背景、功能描述、約束條件 等

/speckit.specify 
1. 背景
- 創建一個任務管理應用，用戶可以對任務進行便捷化管理
2.功能
- 用戶可以創建任務、分配優先級（高/中/低）、設置截止日期，並標記任務完成
- 任務可以按優先級和截止日期過濾
3.約束條件
- 數據使用本地存儲，無需使用數據庫

執行完成之後，Spec Kit會建立 specs/001-local-task-manager 目錄

001-local-task-manager      # 需求目錄
└── checklists/           # 需求檢查點
│  ├── requirements.md
└── spec.md               # 功能需求說明

同時建立 001-local-task-manager 代碼管理分支，之前嘅功能需求都係基於分支開發，唔會影響到主項目

spec.md 文件入面會生成詳細功能規範

checklists/requirements.md 文件會列舉已完成項同待確認項，所有項已經打咗剔，冇【NEEDS CLARIFICATION】待確認項時可以執行下一步

澄清方案（clarify，可選）

如果發現生成嘅需求存在模糊嘅地方，可以用 clarify 進行澄清

/speckit.clarify 添加一個刪除操作，可以刪除任務項

澄清過程中Spec Kit會提供唔同嘅處理方案並俾出推薦方案，選擇方案之後Spec Kit會提出其他需要明確嘅邊界問題，我哋可以透過交互式對話完善需求文檔

澄清完成之後，Spec Kit會更新 spec.md 文件並提示我哋執行下一步計劃

制定技術方案（plan）

制定技術實現方案，描述技術實現方案嘅詳細內容

/speckit.plan 
1.技術棧
- 前端組件使用Tailwindcss + shadcn/ui
- React 18
- 數據存儲在 IndexedDB 中
2.測試覆蓋率
- 測試覆蓋率達到90%

任務執行完成之後，Spec Kit會建立 data-model.md、plan.md、quickstart.md、 research.md 4個文件以及 contracts/storage-interface.ts 接口定義文件

• contracts/storage-interface.ts：TypeScript接口定義

• data-model.md：數據表結構

• plan.md：技術設計方案，包含項目結構、技術選型等

• quickstart.md：項目本地環境指南

• research.md：技術棧詳細內容

拆解任務（tasks）

Spec Kit根據前面制定嘅技術方案將技術方案自動分解為可執行嘅任務單元，直接喺交互式命令中輸入以下指令：

/speckit.tasks

任務執行之後，Spec Kit會建立一個 tasks.md 文件

任務大致格式如下，每一個章節都包含多個任務而且對任務進行咗編號

## Phase 1: Setup (Shared Infrastructure)
**Purpose**: Project initialization and basic structure
- [ ] T001 Initialize Next.js project with TypeScript, Tailwind CSS, and ESLint
- [ ] T002 [P] Install dependencies: `idb`, `clsx`, `tailwind-merge`, `lucide-react`
- [ ] T003 [P] Initialize shadcn/ui and add `button`, `input`, `select`, `checkbox`, `calendar`, `popover` components in src/components/ui/
- [ ] T004 [P] Configure project structure (src/app, src/components, src/lib, src/types)
---
## Phase 2: Foundational (Blocking Prerequisites)
**Purpose**: Core infrastructure that MUST be complete before ANY user story can be implemented
**⚠️ CRITICAL**: No user story work can begin until this phase is complete
- [ ] T005 Define core types (Task, Priority, filters) in src/types/index.ts (matches contracts/storage-interface.ts)
- [ ] T006 Implement IndexedDB service wrapper in src/lib/db.ts using `idb`
- [ ] T007 [P] Create unit test for DB service in src/__tests__/lib/db.test.ts
- [ ] T008 Implement `useTasks` custom hook in src/lib/hooks/useTasks.ts (managing state and DB calls)
- [ ] T009 [P] Create unit test for `useTasks` hook in src/__tests__/hooks/useTasks.test.ts
- [ ] T010 Create global Layout with light theme configuration in src/app/layout.tsx
**Checkpoint**: Foundation ready - DB and State logic tested. User story implementation can now begin.
---

實施任務（implement）

實施任務階段，Spec Kit會根據任務清單依次執行，我哋可以一次過執行所有任務

/speckit.implement

都可以從任務列表選擇一部分任務執行

/speckit.implement 實現T001-T010

接下來就全權交俾AI，AI喺實現任務之後會對已完成任務進行標記

最終實現效果如下，除咗一啲測試用例問題，其他嘅基本上一次過，整體效果都唔錯。

撳關注，及時接收最新消息

小夥伴們大家好，我是小溪，見字如面。隨着AI編程的迅速發展，在軟件開發中，SDD (Spec-Driven Development)規範驅動開發 正在成為一種趨勢，市面上也逐漸湧現出一些優秀的SDD框架與工具，今天要認識的Spec Kit就是由GitHub官方推出的開源工具包，它專門用於實現規格驅動開發，旨在改變開發者與AI編碼助手的協作方式。

當前使用版本

specify-cli v0.0.22

優勢

• 支持 Linux、macOS、Windows系統

• 開源免費

• 適用於 0→1 的項目

• 多平台支持

限制

• Spec Kit依賴 UV 和 Python環境

• 需要對Spec Kit的使用有一定的瞭解

• 生成的文檔默認都是英文的，需要一定的英文閲讀能力

簡介

Spec Kit 是GitHub官方開源的 規範驅動開發（SDD，全稱Spec-Driven Development ） 工具包，它引入了 規範驅動開發 的新型軟件開發模式，通過“規範→計劃→任務→實現”的結構化流程，建立系統化的開發工作流，從而提升代碼質量和開發效率。

Github地址：https://github.com/github/spec-kit

工作流程

Spec Kit提供了以下核心命令：

• /speckit.constitution：制定或更新項目級開發原則和指南，在項目初始化或引入新規範時使用

• /speckit.specify：明確需求範圍和用戶故事，在開始新功能開發時使用

• /speckit.clarify(可選)：澄清需求中的模糊領域，在制定計劃前使用

• /speckit.plan：基於技術棧創建實施方案，在需求明確後使用

• /speckit.tasks：生成可執行的任務清單，在方案確定後使用

• /speckit.analyze(可選)：跨工件一致性和覆蓋率分析，在任務生成後，實施前使用

• /speckit.checklist(可選)：生成質量檢查清單，在需求驗證階段使用

• /speckit.implement：按計劃執行所有開發任務，在任務分解完成後使用

安裝配置

前置條件

• UV包管理工具

• Python 3.11及以上版本

安裝

Spec Kit安裝依賴UV包管理工具，在安裝前需要先安裝UV，對UV還不瞭解的小夥伴可以看往期內容：【Python】Python 版本、項目、包、管理工具UV

$ uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

安裝完成後，在命令行終端輸入 specify version，輸出版本信息表示安裝成功

更新Spec Kit可以使用UV

$ uv tool upgrade specify-cli

也可以使用如下命令更新

$ uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

一次性使用

如果只是一次性使用可以使用uvx允許，原理類似npx

$ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

基本使用

平台支持

Spec Kit支持多種平台和CLI工具

使用不同的平台，需要使用 --ai 進行指定，平台對應的AI助手類型：

• claude

• gemini

• copilot

• cursor-agent

• qwen

• opencode

• codex

• windsurf

• kilocode

• auggie

• roo

• codebuddy

• amp

• shai

• q

• bob

命令行指令

SpecKit提供了命令指令，在命令行終端輸入 specify --help 可以查看幫助文檔

• init：從最新模板初始化一個新的 Specify 項目

• check：檢查所有必需的工具是否已安裝

• version：顯示版本和系統信息

輸入  specify check  可以對使用環境進行檢查

Spec Kit目錄結構

Spec Kit嚴格按照目錄結構進行管理，一個完整的Spec Kit目錄結構大致如下：

.specify
└── memory/                        # 記憶文件
│  ├── constitution.md
└── scripts/                       # spec kit依賴的腳本
│  └── bash/
│    ├── check-prerequisites.sh
│    ├── common.sh
│    ├── create-new-feature.sh
│    ├── setup-plan.sh
│    ├── update-agent-context.sh
└── templates/                     # spec kit命令模版
│  ├── agent-file-template.md
│  ├── checklist-template.md
│  ├── plan-template.md
│  ├── spec-template.md
│  └── tasks-template.md
└── specs/                        # 需求變更
│ └── 001-local-task-manager/
│  └── checklists/               #檢查項 
│    ├── requirements.md
│  └── spec.md                   # 需求規範說明

初始化項目

Spec Kit支持 新項目 和 現有項目 2種初始化方式：

1）新項目初始化

該方式適合從0開始的新項目，直接在命令行終端輸入以下指令：

# 手動選擇AI助手類型
$ specify init <項目名稱>

# 指定AI助手類型
$ specify init <項目名稱> --ai <AI助手類型>

以默認手動選擇AI助手類型配置為例，在命令行終端輸入 specify init my-test 會提示我們先選擇AI助手

回車進入第二步，選擇終端類型，提供了 sh 和 ps 兩種類型（macOS、Linux選sh，Windows選擇ps即可）

回車進入下一步，Spec Kit會根據我們的配置完成初始化，初始化完成後會給出使用Spec Kit的關鍵步驟

Spec Kit會以內置模版 創建項目、生成AI助手自定義命令、生成Spec Kit目錄結構

在交互式命令中輸入 /speckit 就可以看到所有自定義指令

2）現有項目初始化

該方式適合已有項目的初始化，進入項目根目錄，直接在命令行終端輸入以下指令，步驟和新項目初始化一致

# 手動選擇AI助手類型
$ specify init .

# 指定AI助手類型
$ specify init . --ai claude

# 使用--here標識，指定AI助手類型
$ specify init --here --ai claude

制定項目原則（constitution）

定義項目的 最高準則（如團隊約定、技術邊界、代碼質量等），確保AI生成的所有內容符合團隊規範，為後續所有規格、計劃、任務提供指導

/speckit.constitution 
1.項目原則
- 後端接口全部使用Nextjs的API Route，前端調用後端接口
- 使用淺色主題，頁面簡潔、美觀
2.技術約定
- 優先使用原生Web API，避免引入非必要的三方庫
- 保持代碼清晰易讀，不要過度優化
- UI 響應時間保持在100ms以內

執行完成後，Spec Kit會更新 .specify/memory/constitution.md 文件記錄上面的原則和約定，目前Spec Kit默認輸出的為英文版的文檔，如需中文版本需手動翻譯

定義功能需求（specify）

通過自然語言描述需要實現的功能需求，無需包含詳細的技術實現部分，可以包含 項目背景、功能描述、約束條件 等

/speckit.specify 
1. 背景
- 創建一個任務管理應用，用戶可以對任務進行便捷化管理
2.功能
- 用戶可以創建任務、分配優先級（高/中/低）、設置截止日期，並標記任務完成
- 任務可以按優先級和截止日期過濾
3.約束條件
- 數據使用本地存儲，無需使用數據庫

執行完成後，Spec Kit會創建 specs/001-local-task-manager 目錄

001-local-task-manager      # 需求目錄
└── checklists/           # 需求檢查點
│  ├── requirements.md
└── spec.md               # 功能需求說明

同時創建 001-local-task-manager 代碼管理分支，前功能需求都是基於分支開發不會影響到主項目

spec.md 文件中會生成詳細功能規範

checklists/requirements.md 文件會列舉已完成項和待確認項，所有項已打勾，沒有【NEEDS CLARIFICATION】待確認項時可以執行下一步

澄清方案（clarify，可選）

如果發現生成的需求存在模糊之處，可使用 clarify 進行澄清

/speckit.clarify 添加一個刪除操作，可以刪除任務項

澄清過程中Spec Kit會提供不同的處理方案並給出推薦方案，選擇方案後Spec Kit會提出其他需要明確的邊界問題，我們可以通過交互式對話完善需求文檔

澄清完成後，Spec Kit會更新 spec.md 文件並提示我們執行下一步計劃

制定技術方案（plan）

制定技術實現方案，描述技術實現方案的詳細內容

/speckit.plan 
1.技術棧
- 前端組件使用Tailwindcss + shadcn/ui
- React 18
- 數據存儲在 IndexedDB 中
2.測試覆蓋率
- 測試覆蓋率達到90%

任務執行完成後，Spec Kit會創建 data-model.md、plan.md、quickstart.md、 research.md 4個文件以及 contracts/storage-interface.ts 接口定義文件

• contracts/storage-interface.ts：TypeScript接口定義

• data-model.md：數據表結構

• plan.md：技術設計方案，包含 項目結構、技術選型等

• quickstart.md：項目本地環境指南

• research.md：技術棧詳細內容

拆解任務（tasks）

Spec Kit根據前面制定的技術方案將技術方案自動分解為可執行的任務單元，直接在交互式命令中輸入如下指令：

/speckit.tasks

任務執行後，Spec Kit會創建一個 tasks.md 文件

任務大致格式如下，每一個章節都包含多個任務並且對任務進行了編號

## Phase 1: Setup (Shared Infrastructure)
**Purpose**: Project initialization and basic structure
- [ ] T001 Initialize Next.js project with TypeScript, Tailwind CSS, and ESLint
- [ ] T002 [P] Install dependencies: `idb`, `clsx`, `tailwind-merge`, `lucide-react`
- [ ] T003 [P] Initialize shadcn/ui and add `button`, `input`, `select`, `checkbox`, `calendar`, `popover` components in src/components/ui/
- [ ] T004 [P] Configure project structure (src/app, src/components, src/lib, src/types)
---
## Phase 2: Foundational (Blocking Prerequisites)
**Purpose**: Core infrastructure that MUST be complete before ANY user story can be implemented
**⚠️ CRITICAL**: No user story work can begin until this phase is complete
- [ ] T005 Define core types (Task, Priority, filters) in src/types/index.ts (matches contracts/storage-interface.ts)
- [ ] T006 Implement IndexedDB service wrapper in src/lib/db.ts using `idb`
- [ ] T007 [P] Create unit test for DB service in src/__tests__/lib/db.test.ts
- [ ] T008 Implement `useTasks` custom hook in src/lib/hooks/useTasks.ts (managing state and DB calls)
- [ ] T009 [P] Create unit test for `useTasks` hook in src/__tests__/hooks/useTasks.test.ts
- [ ] T010 Create global Layout with light theme configuration in src/app/layout.tsx
**Checkpoint**: Foundation ready - DB and State logic tested. User story implementation can now begin.
---

實施任務（implement）

實施任務階段，Spec Kit會根據任務清單依次執行，我們可以一次性執行所有任務

/speckit.implement

也可以從任務列表選擇一部分任務執行

/speckit.implement 實現T001-T010

接下來就全權交給AI，AI在實現任務後會對已完成任務進行打標

最終實現效果如下，除了一些測試用例問題，其他的基本上一遍過，整體效果還不錯。

點擊關注，及時接收最新消息