Files
ai-proj-helper/skills-req/req-plugin
johnQ e6ebfd6b9f docs(skill): 覆盖率阶段 1 样板 —— req / ai-proj 的 evals 与四段式文档
- skills-req/req-plugin/skills/evals/evals.json(3 条:正常/边界/失败恢复)
- docs/skills/req.md(What/When/Common questions/It's working if)
- skills-core/ai-proj-plugin/skills/evals/evals.json
- docs/skills/ai-proj.md
- coverage: 40 -> 38
2026-11-01 05:07:53 +08:00
..

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

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

概述

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

快速开始

# 列出待处理需求
/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+)

/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。

版本历史

版本 日期 主要变更
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 维护