# 自动化开发工作流技能库

> 基于 Claude Code 的自动化开发全流程技能集合，覆盖需求 → 审核 → 设计 → TDD → 计划 → 开发 → 测试 → 交付的完整闭环。

## 技能清单

| 技能 | 指令 | 说明 | 阶段 |
|------|------|------|------|
| dev-workflow | `/dev-workflow` | 工作流总控，管理全流程进度 | 总控 |
| dev-requirement | `/dev-requirement` | 需求分析，产出需求文档 | 第 1 阶段 |
| dev-review | `/dev-review` | 需求审核，过滤无关/复杂需求 | 第 2 阶段 |
| dev-design | `/dev-design` | 技术设计与选型 | 第 3 阶段 |
| dev-tdd | `/dev-tdd` | 测试先行，生成测试骨架 | 第 4 阶段 |
| dev-plan | `/dev-plan` | 步骤分解，定义验收标准 | 第 5 阶段 |
| dev-develop | `/dev-develop` | 开发执行，让测试变绿 | 第 6 阶段 |
| dev-test | `/dev-test` | 测试验证，代码审核 | 第 7 阶段 |
| dev-deliver | `/dev-deliver` | 交付发布 + 反馈闭环 | 第 8 阶段 |

## 安装方式

### 安装整个技能库

```bash
npx skills add http://jiulu-gameplay.com.cn:13001/congsh/workFlowSkill.git --all
```

### 安装单个技能

```bash
# 安装主控技能
npx skills add http://jiulu-gameplay.com.cn:13001/congsh/workFlowSkill.git --skill dev-workflow

# 安装需求分析技能
npx skills add http://jiulu-gameplay.com.cn:13001/congsh/workFlowSkill.git --skill dev-requirement
```

### 全局安装（推荐）

```bash
npx skills add http://jiulu-gameplay.com.cn:13001/congsh/workFlowSkill.git --all -g -y
```

## 快速开始

安装完成后，在项目目录中：

```bash
# 启动工作流
claude /dev-workflow

# 或直接启动某个阶段
claude /dev-requirement
```

## 权限配置

为获得最佳自动化体验，建议配置权限等级：

```bash
# 开发模式：常用命令自动批准
cp .claude/permissions/level-3-dev.json .claude/settings.json
```

## 工作流流程

```
╔═════════════════════════════════════════════════════════════════════════╗
║                        自动化开发工作流                              ║
╚═════════════════════════════════════════════════════════════════════════╝

┌───────────────┐
│  需求收集   │  /dev-requirement
│  产出文档   │  docs/requirements/
└───────────────┘
        │
        ▼
┌───────────────┐
│  需求审核   │  /dev-review
│  通过/拒绝/  │  docs/reviews/
│  上报决策   │
└───────────────┘
        │
        ▼
┌───────────────┐
│  技术设计   │  /dev-design
│  架构与选型  │  docs/design/
└───────────────┘
        │
        ▼
┌───────────────┐
│  TDD测试   │  /dev-tdd
│  先行     │  docs/test-cases/
└───────────────┘
        │
        ▼
┌───────────────┐
│  步骤分解   │  /dev-plan
│  验收标准   │  docs/plans/
└───────────────┘
        │
        ▼
┌───────────────┐
│  开发执行   │  /dev-develop
│  让测试变绿 │  docs/dev-logs/
└───────────────┘
        │
        ▼
┌───────────────┐
│  测试验证   │  /dev-test
│  审核+测试  │  docs/test-reports/
└───────────────┘
        │
        ▼
┌───────────────┐
│  交付发布   │  /dev-deliver
│  +反馈闭环  │  docs/deliverables/
└───────────────┘
        │
        └──────────┐
                 ▼
          ┌────────────┐
          │  人工反馈  │
          │  驱动迭代  │
          └────────────┘
```

## 更新技能

```bash
# 更新本库所有技能
npx skills update workFlowSkill -y

# 检查是否有更新
npx skills check
```

## 目录结构

```
workFlowSkill/
├── README.md
├── .gitignore
├── dev-workflow/SKILL.md          # 工作流总控
├── dev-requirement/SKILL.md       # 需求分析
├── dev-review/SKILL.md            # 需求审核
├── dev-design/SKILL.md            # 技术设计
├── dev-tdd/SKILL.md               # TDD测试先行
├── dev-plan/SKILL.md              # 步骤分解
├── dev-develop/SKILL.md           # 开发执行
├── dev-test/SKILL.md              # 测试验证
└── dev-deliver/SKILL.md           # 交付发布
```

## 外部工具占位（后续接入）

| 功能 | 当前占位 | 后续替换 |
|------|---------|---------|
| 工单状态同步 | `docs/processed-requirements.md` | 工单系统 API |
| 上报决策人 | `docs/reviews/pending/` | 邮件 MCP / Webhook |
| 定时触发 | 无 | 外部脚本 + Claude CLI |

## License

MIT