AgentSkillsCN

spec

引导规格驱动开发（SDD）工作流程，在实现前规划变更。 使用时机：建立规格、提出方案、规划功能，或使用 OpenSpec 等类似工具。 关键词：spec、specification、SDD、proposal、openspec、design doc、规格、提案、设计文件。

SKILL.md
--- frontmatter
name: spec
description: |
  引導規格驅动开发 (SDD) 工作流程，在实作前規划变更。
  使用时机：建立規格、提案、規划功能、使用 OpenSpec 或类似工具。
  关鍵字：spec, specification, SDD, proposal, openspec, design doc, 規格, 提案, 设计文件。
source: ../../../../skills/spec-driven-dev/SKILL.md
source_version: 1.1.0
translation_version: 1.1.0
last_synced: 2026-01-25
status: current

規格驅动开发指南

语言: English | 简体中文

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

目的

此技能引導您完成規格驅动开发 (SDD)，确保变更在实作前經過規划、记录和批准。

快速參考

SDD 工作流程

code
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│     提案     │───▶│     审查     │───▶│     实作     │
└──────────────┘    └──────────────┘    └──────────────┘
                                               │
                                               ▼
                    ┌──────────────┐    ┌──────────────┐
                    │     封存     │◀───│     验证     │
                    └──────────────┘    └──────────────┘

工作流程阶段

阶段说明产出
提案定義变更内容与原因proposal.md
审查利害关系人批准批准记录
实作执行已批准的規格程序码、测试、文件
验证确认实作符合規格测试結果
封存关閉并封存封存的規格及連結

核心原則

原則说明
規格優先没有批准的規格就不能进行功能变更
工具優先有 SDD 工具时優先使用工具指令
方法論 > 工具SDD 可搭配任何工具或手动流程运作

「規格優先」的例外情况

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

提案範本

markdown
# [SPEC-ID] 功能標題

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

## 动机
为什麼需要这个变更？解决什麼問題？

## 详细设计
技術方案、受影響的元件、数据流程。

## 驗收标准
- [ ] 标准 1
- [ ] 标准 2

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

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

详细指南

完整标准請參考：

AI 優化格式（节省 Token）

AI 助手可使用 YAML 格式文件以減少 Token 使用量：

  • •基礎标准：ai/standards/spec-driven-development.ai.yaml

与其他标准的集成

与提交消息集成

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

code
feat(auth): implement login feature

Implements SPEC-001 login functionality with OAuth2 support.

Refs: SPEC-001

与 Check-in 标准集成

为規格提交程序码前：

  • • 規格已批准
  • • 实作符合規格
  • • 测试涵蓋驗收标准
  • • PR 中引用規格 ID

与程序码审查集成

审查者应验证：

  • • 变更符合已批准的規格
  • • 没有超出規格的範圍擴張
  • • 規格驗收标准已达成

範例

✅ 良好做法

markdown
# SPEC-001 新增 OAuth2 登入

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

## 动机
- 減少新使用者註冊的摩擦
- 不储存密码以提升安全性

## 驗收标准
- [ ] 使用者可以点擊「使用 Google 登入」按鈕
- [ ] 新使用者自动註冊
- [ ] 現有使用者可連結 Google 帳号

❌ 不良做法

markdown
# 新增登入

新增登入功能。
  • •缺少規格 ID
  • •没有动机说明
  • •没有驗收标准

常見 SDD 工具

工具说明指令範例
OpenSpec規格管理/openspec proposal, /openspec approve
Spec Kit輕量規格追蹤/spec create, /spec close
手动無工具，文件式手动建立 specs/SPEC-XXX.md

最佳实踐

建议做法

  • •✅ 保持規格專注且原子化（一个規格一个变更）
  • •✅ 包含清晰的驗收标准
  • •✅ 將規格連結到实作 PR
  • •✅ 完成後封存規格

避免做法

  • •❌ 在規格批准前開始写程序
  • •❌ 实作期间修改範圍但不更新規格
  • •❌ 讓規格处於懸置状态（务必关閉或封存）
  • •❌ 跳過验证步骤

设置偵测

此技能支援项目特定设置。

偵测順序

  1. •检查工作區是否有 SDD 工具（OpenSpec、Spec Kit 等）
  2. •检查 CONTRIBUTING.md 中的規格工作流程文件
  3. •若無找到，预设使用手动文件式工作流程

首次设置

若未找到设置：

  1. •詢問使用者：「此项目尚未设置 SDD。您要设置 specs 目录嗎？」
  2. •建议在 CONTRIBUTING.md 中记录：
markdown
## 規格驅动开发

我們对所有非瑣碎的变更使用規格驅动开发。

### 流程
1. 在 `specs/` 目录建立提案
2. 取得团队負責人批准
3. 实作并在 PR 中引用規格
4. 合併後封存規格

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

相关标准

版本历史

版本日期变更
1.0.02025-12-30初始發布

授权

此技能採用 CC BY 4.0 授权。

來源: universal-dev-standards