SDD Skills for Claude Code

Spec-Driven Development (SDD) 工作流 Skills 包，支持 SAE/ADE 协同开发模式。

🚀 快速开始

# 使用 npx 安装（推荐）
npx sdd-skills

# 或全局安装
npm install -g sdd-skills
sdd-skills

安装后，Skills 将自动加载到 Claude Code 中，您可以直接开始使用 SDD 工作流。

📦 包含的 Skills

| Skill | 角色 | 职责 | |-------|------|------| | sae | 架构师 | 需求分析、架构设计、技术方案 | | developer | 研发工程师 | 前后端代码实现（Go后端、Vue/React前端） | | tester | 测试工程师 | 单元测试、E2E 测试、质量保障 | | code-reviewer | 代码审查专家 | 代码质量、安全审查、规范检查 | | git-engineer | Git 工程师 | 预检测、提交规范、MR 创建 | | notifier | 钉钉通知 | 工作流事件通知、失败告警 |

🔄 工作流程

用户提供需求
  ↓
🗣️ Pre-Execution Review（多角色讨论）
  ├─ SAE 角度：需求清晰度、架构复杂度
  ├─ Developer 角度：技术可行性、性能评估
  ├─ Tester 角度：测试策略、环境需求
  ├─ Code Reviewer 角度：潜在风险、安全关注
  └─ Git Engineer 角度：CI/CD 兼容性
  ↓
汇总反馈 + 用户决策
  ↓
📐 SAE → 需求规格文档
  ↓
👨‍💻 Developer → OpenSpec → 代码实现（后端 + 前端）
  ↓
🧪 Tester → 测试验证
  ├─ 失败 → 📢 钉钉通知 → 返回 Developer 修复
  └─ 成功 ↓
👀 Code Reviewer → 代码审查
  ├─ 失败 → 📢 钉钉通知 → 返回 Developer 修复
  └─ 成功 ↓
🚀 Git Engineer → 预检测 + 提交 + MR
  ├─ 失败 → 📢 钉钉通知 → 返回 Developer 修复
  └─ 成功 ↓
✅ 完成（等待 MR 批准）

💡 使用示例

1. 开始一个新功能

你: 帮我实现用户登录功能，支持邮箱和手机号登录

Claude (自动激活 SAE Skill):
📍 Pre-Execution Review

🗣️ SAE 角度：
- 需求清晰度：⭐⭐⭐⭐
- 需要澄清：是否需要第三方登录？密码策略？
- 架构复杂度：中等
...

[各角色依次给出反馈]

📋 汇总反馈：整体可行，需澄清3个问题...

你: [回答问题后] 继续

Claude (SAE Skill):
✅ 已生成需求规格：specs/requirements/user-login.md
...

2. 钉钉通知示例

当测试失败时，您将收到钉钉消息：

❌ SDD 工作流失败

- 工作流: user-login
- 失败阶段: Tester
- 错误信息: 3/10 测试用例失败
- 建议操作: 返回 Developer 修复

🕐 时间: 2026-01-06 14:30:00

⚙️ 配置钉钉通知

安装时可选配置，或手动创建配置文件：

# 全局配置
~/.claude/dingtalk-config.json

# 项目配置
<project>/.claude/dingtalk-config.json

配置内容：

{
  "webhook_url": "https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN",
  "notify_on": ["failure", "success"]
}

注意: 钉钉消息必须包含 "SDD" 关键字（已内置）。

🛠️ 本地开发

# 克隆项目
git clone https://git.in.chaitin.net/yusheng.wang/sdd-skills.git
cd sdd-skills

# 安装依赖
npm install

# 本地测试
npm link
sdd-skills

# 卸载
npm unlink -g sdd-skills

📚 技术栈说明

Developer Skill (研发工程师)

后端技术栈:

• 语言: Go 1.21+
• 框架: Gin / Echo / Fiber
• 数据库: PostgreSQL, MySQL, Redis
• 测试: go test, testify, gomock
• 覆盖率要求: >= 90%

前端技术栈:

• 框架: Vue 3 / React 18+ (支持多框架)
• 状态管理: Pinia / Redux Toolkit / Zustand
• 构建工具: Vite
• 测试: Vitest / Jest, Playwright
• 覆盖率要求: >= 90%

Git Engineer Skill

• VCS: GitLab (使用 glab CLI)
• 预检测: lint, build, test
• 提交规范: Conventional Commits
• MR: 手动指定审查人

🔧 卸载

# 使用 npx
npx sdd-skills uninstall

# 或如果全局安装
sdd-skills uninstall

📖 文档

• 完整文档: https://git.in.chaitin.net/yusheng.wang/sdd-skills
• 问题反馈: https://git.in.chaitin.net/yusheng.wang/sdd-skills/-/issues
• 工作流指南: docs/workflow-guide.md

🤝 贡献

欢迎贡献！请：

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Merge Request

📄 License

MIT License - 详见 LICENSE 文件

👥 作者

Yusheng Wang - 长亭科技研发负责人

• GitLab: @yusheng.wang
• Email: [email protected]

SDD (Spec-Driven Development) - 以规格书驱动开发，实现 AI × 人协同的高效研发模式