John Qiu
712063071c
skills/ → skills-dev(9), skills-req(10), skills-ops(4), skills-integration(8), skills-biz(4), skills-workflow(7) generate-marketplace.py 改为自动扫描所有 skills-* 目录。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
112 lines
2.9 KiB
Markdown
112 lines
2.9 KiB
Markdown
# 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 维护*
|