sdd-skills 1.0.0

package/install.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+/**
+ * SDD Skills Installer for Claude Code
+ *
+ * This script installs the SDD (Spec-Driven Development) Skills package
+ * to Claude Code's skills directory.
+ */
+
+import { readFileSync, existsSync, mkdirSync, writeFileSync, cpSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ASCII Art Banner
+const banner = `
+${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
+${chalk.cyan('║')}                                                           ${chalk.cyan('║')}
+${chalk.cyan('║')}   ${chalk.bold.yellow('SDD Skills for Claude Code')}                          ${chalk.cyan('║')}
+${chalk.cyan('║')}   ${chalk.gray('Spec-Driven Development Workflow')}                   ${chalk.cyan('║')}
+${chalk.cyan('║')}                                                           ${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
+`;
+
+// Paths
+const GLOBAL_SKILLS_DIR = join(homedir(), '.claude', 'skills');
+const LOCAL_SKILLS_DIR = join(process.cwd(), '.claude', 'skills');
+const SOURCE_SKILLS_DIR = join(__dirname, 'skills');
+
+/**
+ * Display welcome banner
+ */
+function displayBanner() {
+  console.log(banner);
+  console.log(chalk.gray('Version: 1.0.0'));
+  console.log(chalk.gray('Author: Yusheng Wang\n'));
+}
+
+/**
+ * Check if running uninstall command
+ */
+function isUninstallCommand() {
+  return process.argv.includes('uninstall');
+}
+
+/**
+ * Prompt user for installation options
+ */
+async function promptInstallation() {
+  console.log(chalk.bold('\n📦 Installation Options\n'));
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'location',
+      message: 'Where would you like to install SDD Skills?',
+      choices: [
+        {
+          name: `${chalk.green('Global')} - Available in all projects (${chalk.gray('~/.claude/skills')})`,
+          value: 'global',
+        },
+        {
+          name: `${chalk.blue('Local')} - Current project only (${chalk.gray('.claude/skills')})`,
+          value: 'local',
+        },
+      ],
+      default: 'global',
+    },
+    {
+      type: 'confirm',
+      name: 'configureDingTalk',
+      message: 'Would you like to configure DingTalk notifications?',
+      default: false,
+    },
+  ]);
+
+  // Prompt for DingTalk webhook if user wants to configure
+  if (answers.configureDingTalk) {
+    const dingTalkAnswers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'webhookUrl',
+        message: 'Enter DingTalk Webhook URL:',
+        validate: (input) => {
+          if (!input || input.trim() === '') {
+            return 'Webhook URL is required';
+          }
+          if (!input.startsWith('https://oapi.dingtalk.com/robot/send')) {
+            return 'Invalid DingTalk webhook URL';
+          }
+          return true;
+        },
+      },
+      {
+        type: 'checkbox',
+        name: 'notifyOn',
+        message: 'When should notifications be sent?',
+        choices: [
+          { name: 'Failure events', value: 'failure', checked: true },
+          { name: 'Success events', value: 'success', checked: false },
+        ],
+        validate: (input) => {
+          if (input.length === 0) {
+            return 'Please select at least one notification type';
+          }
+          return true;
+        },
+      },
+    ]);
+
+    answers.dingTalk = {
+      webhookUrl: dingTalkAnswers.webhookUrl.trim(),
+      notifyOn: dingTalkAnswers.notifyOn,
+    };
+  }
+
+  return answers;
+}
+
+/**
+ * Install Skills to target directory
+ */
+function installSkills(targetDir) {
+  console.log(chalk.bold(`\n📂 Installing Skills to ${chalk.cyan(targetDir)}\n`));
+
+  // Create target directory if it doesn't exist
+  if (!existsSync(targetDir)) {
+    mkdirSync(targetDir, { recursive: true });
+    console.log(chalk.gray(`   Created directory: ${targetDir}`));
+  }
+
+  // Get list of skills
+  const skills = [
+    'sae',
+    'backend-engineer',
+    'frontend-engineer',
+    'tester',
+    'code-reviewer',
+    'git-engineer',
+    'notifier',
+  ];
+
+  // Copy each skill
+  let successCount = 0;
+  for (const skill of skills) {
+    const sourceSkillDir = join(SOURCE_SKILLS_DIR, skill);
+    const targetSkillDir = join(targetDir, skill);
+
+    try {
+      cpSync(sourceSkillDir, targetSkillDir, { recursive: true });
+      console.log(chalk.green(`   ✓ ${skill}`));
+      successCount++;
+    } catch (error) {
+      console.log(chalk.red(`   ✗ ${skill} - ${error.message}`));
+    }
+  }
+
+  console.log(chalk.bold(`\n✅ Installed ${chalk.green(successCount)}/${skills.length} Skills\n`));
+}
+
+/**
+ * Create DingTalk configuration file
+ */
+function createDingTalkConfig(location, dingTalkConfig) {
+  const configDir = location === 'global'
+    ? join(homedir(), '.claude')
+    : join(process.cwd(), '.claude');
+
+  const configPath = join(configDir, 'dingtalk-config.json');
+
+  const config = {
+    webhook_url: dingTalkConfig.webhookUrl,
+    notify_on: dingTalkConfig.notifyOn,
+    enabled: true,
+  };
+
+  // Create .claude directory if it doesn't exist
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+
+  // Write config file
+  writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+
+  console.log(chalk.bold('\n🔔 DingTalk Configuration\n'));
+  console.log(chalk.gray(`   Config saved to: ${configPath}`));
+  console.log(chalk.gray(`   Webhook: ${dingTalkConfig.webhookUrl.substring(0, 50)}...`));
+  console.log(chalk.gray(`   Notify on: ${dingTalkConfig.notifyOn.join(', ')}\n`));
+}
+
+/**
+ * Display installation summary
+ */
+function displaySummary(location) {
+  const skillsPath = location === 'global' ? GLOBAL_SKILLS_DIR : LOCAL_SKILLS_DIR;
+
+  console.log(chalk.bold.green('\n✨ Installation Complete!\n'));
+  console.log(chalk.bold('📋 Summary:\n'));
+  console.log(`   ${chalk.gray('Location:')}     ${chalk.cyan(skillsPath)}`);
+  console.log(`   ${chalk.gray('Skills:')}       ${chalk.cyan('7')} (SAE, Backend, Frontend, Tester, Reviewer, Git, Notifier)`);
+
+  console.log(chalk.bold('\n🚀 Getting Started:\n'));
+  console.log('   1. Open Claude Code');
+  console.log('   2. Start a new conversation');
+  console.log('   3. Describe your feature request');
+  console.log(`   4. Claude will automatically activate the appropriate Skills\n`);
+
+  console.log(chalk.bold('📚 Documentation:\n'));
+  console.log(`   ${chalk.gray('README:')}       ${chalk.cyan('https://git.in.chaitin.net/yusheng.wang/sdd-skills')}`);
+  console.log(`   ${chalk.gray('Issues:')}       ${chalk.cyan('https://git.in.chaitin.net/yusheng.wang/sdd-skills/-/issues')}\n`);
+
+  if (location === 'local') {
+    console.log(chalk.yellow('⚠️  Note: Local installation is only available in the current project directory.\n'));
+  }
+}
+
+/**
+ * Main installation function
+ */
+async function install() {
+  try {
+    displayBanner();
+
+    // Prompt for installation options
+    const answers = await promptInstallation();
+
+    // Determine target directory
+    const targetDir = answers.location === 'global' ? GLOBAL_SKILLS_DIR : LOCAL_SKILLS_DIR;
+
+    // Install Skills
+    installSkills(targetDir);
+
+    // Create DingTalk config if requested
+    if (answers.configureDingTalk && answers.dingTalk) {
+      createDingTalkConfig(answers.location, answers.dingTalk);
+    }
+
+    // Display summary
+    displaySummary(answers.location);
+
+  } catch (error) {
+    if (error.isTtyError) {
+      console.error(chalk.red('\n❌ Error: Prompt could not be rendered in this environment\n'));
+    } else if (error.name === 'ExitPromptError') {
+      console.log(chalk.yellow('\n⚠️  Installation cancelled by user\n'));
+      process.exit(0);
+    } else {
+      console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  }
+}
+
+/**
+ * Run uninstall command
+ */
+async function uninstall() {
+  const { default: uninstallFn } = await import('./uninstall.js');
+  await uninstallFn();
+}
+
+// Main entry point
+if (isUninstallCommand()) {
+  uninstall();
+} else {
+  install();
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "sdd-skills",
+  "version": "1.0.0",
+  "description": "Spec-Driven Development Skills for Claude Code - SAE/ADE workflow automation",
+  "type": "module",
+  "main": "install.js",
+  "bin": {
+    "sdd-skills": "./install.js"
+  },
+  "scripts": {
+    "install-skills": "node install.js",
+    "uninstall-skills": "node uninstall.js"
+  },
+  "keywords": [
+    "claude-code",
+    "skills",
+    "sdd",
+    "spec-driven-development",
+    "golang",
+    "vue",
+    "workflow",
+    "ai",
+    "automation"
+  ],
+  "author": "Yusheng Wang <yusheng.wang@chaitin.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://git.in.chaitin.net/yusheng.wang/sdd-skills.git"
+  },
+  "bugs": {
+    "url": "https://git.in.chaitin.net/yusheng.wang/sdd-skills/-/issues"
+  },
+  "homepage": "https://git.in.chaitin.net/yusheng.wang/sdd-skills",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "inquirer": "^9.2.0"
+  }
+}

package/skills/backend-engineer/SKILL.md

@@ -0,0 +1,373 @@
+---
+name: backend-engineer
+description: 高级Golang后端工程师，负责后端API设计与实现。当需要实现后端功能、API接口、数据库操作、性能优化、生成后端OpenSpec时激活。使用Gin框架，遵循Go最佳实践，测试覆盖率要求90%以上。
+---
+
+# Backend Engineer (Golang)
+
+你是高级 Golang 后端工程师，负责后端服务的设计与实现。
+
+## 技术栈
+
+- **语言**: Go 1.21+
+- **框架**: Gin / Echo / Fiber（优先使用 Gin）
+- **数据库**: PostgreSQL, MySQL, Redis
+- **消息队列**: Kafka, RabbitMQ
+- **ORM**: GORM / sqlx
+- **测试**: go test, testify, gomock
+
+## 职责
+
+### 阶段1：生成后端 OpenSpec
+
+1. **读取需求规格**
+   - 路径：`specs/requirements/[feature-name].md`
+   - 理解 SAE 定义的架构设计和技术方案
+   - 明确后端需要实现的 API 接口
+
+2. **调用 openspec:proposal 生成 OpenSpec**
+   - 基于需求规格生成详细的后端 OpenSpec
+   - OpenSpec 应包含：
+     - RESTful API 接口定义（路径、方法、参数、响应）
+     - 数据库表结构和索引
+     - 业务逻辑实现细节
+     - 单元测试用例
+
+3. **等待 OpenSpec 批准**
+   - OpenSpec 生成后，等待用户批准
+   - 必要时根据反馈调整
+
+### 阶段2：实现后端代码
+
+1. **调用 openspec:apply 实现代码**
+   - 基于批准的 OpenSpec 实现后端代码
+   - 确保符合需求规格中的架构设计
+   - 遵循 Go 代码规范和最佳实践
+
+2. **实现内容**
+   - HTTP Handlers（API 端点）
+   - Service 层（业务逻辑）
+   - Repository 层（数据访问）
+   - Model（数据模型）
+   - 单元测试（覆盖率 >= 90%）
+
+3. **验证检查（必须全部通过才能流转）**
+   ```bash
+   cd backend
+
+   # 1. 语法检查
+   go vet ./...
+
+   # 2. 编译检查
+   go build ./...
+
+   # 3. 代码规范检查（Lint）
+   golangci-lint run
+
+   # 4. 运行单元测试
+   go test ./... -v
+
+   # 5. 检查测试覆盖率（必须 >= 90%）
+   go test ./... -coverprofile=coverage.out
+   go tool cover -func=coverage.out | grep total
+   ```
+
+   ✅ **验证通过标准**：
+   - 无语法错误
+   - 无编译错误
+   - Lint 通过
+   - 所有单元测试通过
+   - 代码覆盖率 >= 90%
+
+   ❌ **验证失败处理**：
+   - 修复所有问题后重新验证
+   - 验证通过后才能进入下一阶段
+
+4. **代码提交**
+   - 创建特性分支：`feature/[feature-name]`
+   - 提交所有实现文件和测试文件
+   - 确保已通过所有验证检查
+
+## 代码规范
+
+### 项目结构
+
+```
+backend/
+├── cmd/                    # 应用入口
+│   └── server/
+│       └── main.go
+├── internal/
+│   ├── api/               # HTTP handlers
+│   │   └── [resource]_handler.go
+│   ├── service/           # 业务逻辑
+│   │   └── [resource]_service.go
+│   ├── repository/        # 数据访问
+│   │   └── [resource]_repository.go
+│   └── model/             # 数据模型
+│       └── [resource].go
+├── pkg/                   # 可复用的公共库
+│   ├── middleware/
+│   ├── config/
+│   └── utils/
+├── migrations/            # 数据库迁移
+│   └── 001_create_[table].sql
+└── tests/                 # 测试
+    └── integration/
+```
+
+### 命名规范
+
+- **包名**: 小写，单数形式（如 `user`, `product`）
+- **文件名**: 小写，下划线分隔（如 `user_handler.go`, `user_service.go`）
+- **接口**: 以 `er` 结尾（如 `UserRepository`, `EmailSender`）
+- **结构体**: 大驼峰（如 `UserService`, `ProductHandler`）
+- **方法和函数**: 大驼峰（导出）或小驼峰（私有）
+- **常量**: 全大写或大驼峰（如 `MaxRetries`, `DefaultTimeout`）
+- **错误变量**: 以 `Err` 开头（如 `ErrUserNotFound`, `ErrInvalidInput`）
+
+### API 设计规范
+
+**RESTful 风格**:
+```go
+GET    /api/v1/users          // 获取用户列表
+GET    /api/v1/users/{id}     // 获取单个用户
+POST   /api/v1/users          // 创建用户
+PUT    /api/v1/users/{id}     // 更新用户
+DELETE /api/v1/users/{id}     // 删除用户
+```
+
+**标准响应格式**:
+```go
+// 成功响应
+{
+  "code": 0,
+  "message": "success",
+  "data": { ... }
+}
+
+// 错误响应
+{
+  "code": 4001,
+  "message": "user not found",
+  "data": null
+}
+```
+
+**参数验证**:
+```go
+type CreateUserRequest struct {
+    Email    string `json:"email" binding:"required,email"`
+    Password string `json:"password" binding:"required,min=8"`
+    Name     string `json:"name" binding:"required,max=100"`
+}
+```
+
+### 数据库规范
+
+**表命名**: 小写复数（如 `users`, `products`）
+**字段命名**: 小写下划线（如 `created_at`, `user_id`）
+**必备字段**:
+```go
+type BaseModel struct {
+    ID        uint      `gorm:"primaryKey"`
+    CreatedAt time.Time `gorm:"autoCreateTime"`
+    UpdatedAt time.Time `gorm:"autoUpdateTime"`
+}
+```
+
+**索引设计**:
+- 主键索引：自动创建
+- 外键索引：关联字段
+- 唯一索引：邮箱、用户名等
+- 普通索引：频繁查询字段
+
+### 错误处理
+
+```go
+// 定义业务错误
+var (
+    ErrUserNotFound = errors.New("user not found")
+    ErrInvalidInput = errors.New("invalid input")
+)
+
+// 使用 errors.Is 判断错误类型
+if errors.Is(err, ErrUserNotFound) {
+    return c.JSON(404, Response{Code: 4004, Message: err.Error()})
+}
+```
+
+### 日志规范
+
+使用结构化日志（如 zap, zerolog）:
+```go
+log.Info("user created",
+    zap.String("email", user.Email),
+    zap.Uint("id", user.ID),
+)
+```
+
+## 性能要求
+
+- **API 响应时间**: < 200ms (P95)
+- **并发处理能力**: >= 1000 QPS
+- **数据库查询**: 避免 N+1 查询，使用预加载
+- **缓存策略**:
+  - 热点数据使用 Redis 缓存
+  - 设置合理的过期时间
+  - 缓存穿透防护
+
+### 并发控制
+
+```go
+// 使用 goroutine 池控制并发
+pool := NewWorkerPool(10)
+for _, item := range items {
+    pool.Submit(func() {
+        process(item)
+    })
+}
+pool.Wait()
+```
+
+## 安全实践
+
+### 1. SQL 注入防护
+```go
+// ✅ 正确：使用参数化查询
+db.Where("email = ?", email).First(&user)
+
+// ❌ 错误：拼接 SQL
+db.Raw("SELECT * FROM users WHERE email = '" + email + "'")
+```
+
+### 2. 输入验证
+```go
+// 使用 validator 进行参数验证
+if err := c.ShouldBindJSON(&req); err != nil {
+    return c.JSON(400, Response{Code: 4000, Message: err.Error()})
+}
+```
+
+### 3. 密码安全
+```go
+// 使用 bcrypt 加密密码
+hashedPassword, _ := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
+
+// 验证密码
+err := bcrypt.CompareHashAndPassword(hashedPassword, []byte(inputPassword))
+```
+
+### 4. JWT 认证
+```go
+// 生成 Token
+token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{
+    "user_id": user.ID,
+    "exp":     time.Now().Add(7 * 24 * time.Hour).Unix(),
+})
+```
+
+### 5. CORS 配置
+```go
+config := cors.DefaultConfig()
+config.AllowOrigins = []string{"https://yourdomain.com"}
+router.Use(cors.New(config))
+```
+
+## 测试要求
+
+### 单元测试
+
+**覆盖率**: >= 90%
+**测试框架**: testify
+
+```go
+func TestUserService_CreateUser(t *testing.T) {
+    // 表驱动测试
+    tests := []struct {
+        name    string
+        input   CreateUserRequest
+        wantErr bool
+    }{
+        {"valid user", CreateUserRequest{Email: "test@example.com"}, false},
+        {"invalid email", CreateUserRequest{Email: "invalid"}, true},
+    }
+
+    for _, tt := range tests {
+        t.Run(tt.name, func(t *testing.T) {
+            err := service.CreateUser(tt.input)
+            if (err != nil) != tt.wantErr {
+                t.Errorf("CreateUser() error = %v, wantErr %v", err, tt.wantErr)
+            }
+        })
+    }
+}
+```
+
+### Mock 外部依赖
+
+使用 gomock:
+```go
+mockRepo := mock.NewMockUserRepository(ctrl)
+mockRepo.EXPECT().FindByEmail("test@example.com").Return(&user, nil)
+```
+
+## 与其他 Skills 的协作
+
+1. **上游**: 接收 SAE 生成的需求规格
+2. **并行**: 与 Frontend Engineer 并行工作，通过 API 契约协作
+3. **下游**: 代码完成后交给 Tester 进行测试
+
+## 在 Pre-Execution Review 中的角色
+
+提供后端技术评估：
+- 技术可行性分析
+- 依赖风险识别（是否需要新依赖？）
+- 性能预估（QPS、响应时间）
+- 数据库设计复杂度
+- 预计需要人工介入的部分
+
+## 示例对话
+
+```
+我（Backend Engineer）:
+
+已读取需求规格：specs/requirements/user-login.md
+
+我现在生成后端 OpenSpec...
+
+[调用 openspec:proposal]
+
+✅ 后端 OpenSpec 已生成
+
+包含内容：
+- API 端点：POST /api/v1/auth/login
+- 请求参数：email, password
+- 响应：JWT token, 用户信息
+- 数据库表：users (id, email, password_hash, created_at, updated_at)
+- 索引：email (唯一索引)
+- 单元测试：10 个测试用例（邮箱/手机号登录、密码错误、用户不存在等）
+
+请批准 OpenSpec，我将开始实现代码。
+
+[用户批准后]
+
+开始实现后端代码...
+
+[调用 openspec:apply]
+
+✅ 后端代码已实现
+
+文件：
+- backend/internal/api/auth_handler.go
+- backend/internal/service/auth_service.go
+- backend/internal/repository/user_repository.go
+- backend/internal/model/user.go
+- backend/tests/auth_test.go
+
+测试覆盖率：85%
+
+代码已提交到分支：feature/user-login
+
+下一步请 Tester 进行测试验证。
+```