---

name: spec-driven-dev description: | 引導規格驅動開發 (SDD) 工作流程，在實作前規劃變更。 使用時機：建立規格、提案、規劃功能、使用 OpenSpec 或類似工具。 關鍵字：spec, specification, SDD, proposal, openspec, design doc, 規格, 提案, 設計文件。 source: ../../../../../skills/claude-code/spec-driven-dev/SKILL.md source_version: 1.0.0 translation_version: 1.0.0 last_synced: 2026-01-08 status: current

規格驅動開發指南

語言: English | 繁體中文

版本: 1.0.0 最後更新: 2025-12-30 適用範圍: Claude Code Skills

---

目的

此技能引導您完成規格驅動開發 (SDD)，確保變更在實作前經過規劃、記錄和批准。

快速參考

SDD 工作流程

Copy┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│     提案     │───▶│     審查     │───▶│     實作     │
└──────────────┘    └──────────────┘    └──────────────┘
                                               │
                                               ▼
                    ┌──────────────┐    ┌──────────────┐
                    │     封存     │◀───│     驗證     │
                    └──────────────┘    └──────────────┘

工作流程階段

核心原則

「規格優先」的例外情況

• 緊急修復（先恢復服務，之後再補文件）
• 瑣碎變更（錯字、註解、格式調整）

提案範本

Copy# [SPEC-ID] 功能標題

## 摘要
簡要描述提案的變更。

## 動機
為什麼需要這個變更？解決什麼問題？

## 詳細設計
技術方案、受影響的元件、資料流程。

## 驗收標準
- [ ] 標準 1
- [ ] 標準 2

## 相依性
列出對其他規格或外部系統的相依性。

## 風險
潛在風險及緩解策略。

詳細指南

完整標準請參考：

• 規格驅動開發標準

AI 優化格式（節省 Token）

AI 助手可使用 YAML 格式檔案以減少 Token 使用量：

• 基礎標準：ai/standards/spec-driven-development.ai.yaml

與其他標準的整合

與提交訊息整合

在提交訊息中引用規格 ID：

Copyfeat(auth): implement login feature

Implements SPEC-001 login functionality with OAuth2 support.

Refs: SPEC-001

與 Check-in 標準整合

為規格提交程式碼前：

• 規格已批准
• 實作符合規格
• 測試涵蓋驗收標準
• PR 中引用規格 ID

與程式碼審查整合

審查者應驗證：

• 變更符合已批准的規格
• 沒有超出規格的範圍擴張
• 規格驗收標準已達成

範例

✅ 良好做法

Copy# SPEC-001 新增 OAuth2 登入

## 摘要
新增 Google OAuth2 登入，讓使用者可以用 Google 帳號登入。

## 動機
- 減少新使用者註冊的摩擦
- 不儲存密碼以提升安全性

## 驗收標準
- [ ] 使用者可以點擊「使用 Google 登入」按鈕
- [ ] 新使用者自動註冊
- [ ] 現有使用者可連結 Google 帳號

❌ 不良做法

Copy# 新增登入

新增登入功能。

• 缺少規格 ID
• 沒有動機說明
• 沒有驗收標準

常見 SDD 工具

最佳實踐

建議做法

• ✅ 保持規格專注且原子化（一個規格一個變更）
• ✅ 包含清晰的驗收標準
• ✅ 將規格連結到實作 PR
• ✅ 完成後封存規格

避免做法

• ❌ 在規格批准前開始寫程式
• ❌ 實作期間修改範圍但不更新規格
• ❌ 讓規格處於懸置狀態（務必關閉或封存）
• ❌ 跳過驗證步驟

---

設定偵測

此技能支援專案特定設定。

偵測順序

1. 檢查工作區是否有 SDD 工具（OpenSpec、Spec Kit 等）
2. 檢查 CONTRIBUTING.md 中的規格工作流程文件
3. 若無找到，預設使用手動檔案式工作流程

首次設定

若未找到設定：

1. 詢問使用者：「此專案尚未設定 SDD。您要設定 specs 目錄嗎？」
2. 建議在 CONTRIBUTING.md 中記錄：

Copy## 規格驅動開發

我們對所有非瑣碎的變更使用規格驅動開發。

### 流程
1. 在 `specs/` 目錄建立提案
2. 取得團隊負責人批准
3. 實作並在 PR 中引用規格
4. 合併後封存規格

### 規格範本
請參考 `specs/TEMPLATE.md`

---

相關標準

• 規格驅動開發標準
• 提交訊息指南
• 程式碼審查檢查清單

---

版本歷史

---

授權

此技能採用 CC BY 4.0 授權。

來源: universal-dev-standards