# req - 需求全流程工作流管理技能

> 版本: v3.9.0 | 更新日期: 2026-01-25

## 概述

`req` 技能是一个深度集成 ai-proj MCP 工具的需求管理解决方案，支持需求全生命周期管理：从创建、评审、开发、测试到发布归档。

## 快速开始

```bash
# 列出待处理需求
/req list

# 创建新需求
/req new 商品管理模块

# 开始开发
/req dev REQ-2026-0001

# 提交评审
/req review REQ-2026-0001

# 归档完成
/req done REQ-2026-0001
```

## 核心命令

| 命令 | 功能 |
|------|------|
| `/req` 或 `/req list` | 列出需求 |
| `/req new [标题]` | 创建新需求 |
| `/req dev [REQ-ID]` | 开始开发 |
| `/req test [REQ-ID]` | 执行测试 |
| `/req review [REQ-ID]` | 提交评审 |
| `/req done [REQ-ID]` | 归档需求 |
| `/req status [REQ-ID]` | 查看状态 |

## 扩展命令 (v3.3.0+)

| 命令 | 功能 |
|------|------|
| `/req priority [REQ-ID] [high/medium/low]` | 设置优先级 |
| `/req depends [REQ-ID] --on [REQ-ID]` | 设置依赖 |
| `/req deadline [REQ-ID] [日期]` | 设置截止日期 |
| `/req sprint [REQ-ID] [sprint-id]` | 分配迭代 |
| `/req assign [REQ-ID] [用户]` | 指派负责人 |
| `/req generate-tasks [REQ-ID]` | 自动生成任务 |
| `/req stats [REQ-ID]` | 查看统计 |

## Hook 自动同步 (v3.5.0+)

支持在以下事件自动触发同步：
- `requirement.created` - 创建需求
- `requirement.approved` - 需求审批通过
- `requirement.archived` - 需求归档
- `task.completed` - 任务完成
- `document.updated` - 文档更新

## 多人审批 (v3.7.0+)

```bash
/req review pass REQ-2026-0001    # 审批通过
/req review reject REQ-2026-0001  # 审批拒绝
/req review status REQ-2026-0001  # 查看审批状态
```

## 需求状态流转

```
draft → pending → reviewing → approved → archived
                     ↓
                  rejected
```

## 文件结构

```
~/.claude/skills/req/
├── SKILL.md              # 完整技能文档
├── README.md             # 本文件
├── notify.sh             # 邮件通知脚本
└── update-siyuan-release.sh  # 思源笔记更新脚本
```

## 依赖

- **ai-proj MCP 服务** - 需求、任务、文档管理
- **思源笔记 MCP** - 文档同步（可选）
- **邮件服务** - 通知功能（可选）

## 详细文档

完整命令说明、配置选项和使用示例请参阅 [SKILL.md](./SKILL.md)。

## 版本历史

| 版本 | 日期 | 主要变更 |
|------|------|----------|
| v3.9.0 | 2026-01-25 | 生产环境截图验证必须步骤 |
| v3.8.0 | 2026-01-13 | 废弃命令文档化 |
| v3.7.0 | 2026-01-13 | 多人审批增强 |
| v3.6.0 | 2026-01-13 | new/dev/done 命令增强 |
| v3.5.0 | 2026-01-13 | Hook 自动同步机制 |
| v3.4.0 | 2026-01-13 | generate-tasks, stats 命令 |
| v3.3.0 | 2026-01-13 | priority/depends/deadline/sprint/assign 命令 |

---

*由 Claude AI 维护*