feat: P1-10/12/13/14 风险扫描 + 粒度判断 + Issue 集成 + PRD 校验 (REQ-20260416-0017)
P1-10: pm-risk skill — 三维度风险扫描 需求层: 停滞/草稿滞留/开发无提交/测试超期/批准未开发 代码层: 未合并分支/频繁修复文件/提交频率下降 流程层: 跳过评审/PR 无 review/测试门禁跳过/直接推 main 三级风险: 🔴 严重 / 🟡 警告 / 🔵 提示 P1-12: req-prd 需求粒度 AI 判断 创建前启发式检查:标题过宽建议拆分、过窄建议合并或改 task 粒度参考表 + 已有需求扩展决策表 + 前后端拆分规则 P1-13: dev-commit issue 集成规范 分支名 -iN 后缀传递 issue 编号 commit message 自动追加 closes #N P1-14: hooks/validate-prd.sh — PRD 章节校验 PostToolUse hook 自动检查 10 个必需章节 缺失时给出明确提示 marketplace: 48 → 49 plugins (新增 pm-risk-plugin)
This commit is contained in:
@@ -172,6 +172,81 @@ description: 产品设计与需求管理。用于 PRD 文档编写、需求分
|
||||
|
||||
---
|
||||
|
||||
## 需求粒度判断(REQ-20260416-0017 P1-12)
|
||||
|
||||
**创建需求前,AI 必须先对标题做粒度预判。** 借鉴 devflow-claude `/req:split`。
|
||||
|
||||
### 核心问题
|
||||
|
||||
> **"这个需求完成后,用户能感知到一个完整的功能变化吗?"**
|
||||
> - 能 → 粒度合适
|
||||
> - 不能(太大或太小)→ 需调整
|
||||
|
||||
### 粒度参考表
|
||||
|
||||
| 标题示例 | 粒度 | 建议 |
|
||||
|---------|------|------|
|
||||
| "用户积分系统"(含规则+查询+兑换+排行) | 太大 | 拆为 4 个需求 |
|
||||
| "用户积分-积分规则管理"(含 CRUD+校验) | 合适 | 直接创建 |
|
||||
| "用户积分-新增积分接口"(仅一个 API) | 太小 | 合并到功能级需求,或用任务(task) |
|
||||
| "用户积分-新增 model 层"(按技术层拆) | 错误 | 按功能拆,不按技术层拆 |
|
||||
|
||||
### AI 自动检测规则
|
||||
|
||||
**标题过宽信号**(建议拆分):
|
||||
- 含"系统"/"模块"/"平台"/"管理"等宏观词
|
||||
- 描述中功能点 > 5 个
|
||||
- 预估涉及文件 > 15 个
|
||||
|
||||
**标题过窄信号**(建议合并或改 task):
|
||||
- 含"新增XX接口"/"修改XX字段"/"加一个按钮"
|
||||
- 单个 CRUD 操作
|
||||
- 预估涉及文件 ≤ 2 个
|
||||
|
||||
**错误拆分信号**(按技术层拆了):
|
||||
- 标题含"model 层"/"service 层"/"handler 层"/"前端样式"
|
||||
- 同一业务被拆为"后端接口"和"前端页面"两个独立需求
|
||||
|
||||
### 执行时机
|
||||
|
||||
1. **创建需求时**(`/req new` 或 `create_requirement`):检查标题,给出建议
|
||||
2. **编辑需求时**:功能清单超 8 项时提醒"是否应拆分"
|
||||
3. **独立评估**:用 `/req split <标题>` 预判粒度
|
||||
|
||||
### 三种输出
|
||||
|
||||
1. **粒度合适** → 正常创建
|
||||
2. **建议拆分** → 列出子功能建议,用户确认后批量创建
|
||||
3. **建议改 task/QUICK** → 提示"这个用任务更合适"
|
||||
|
||||
### 已有需求扩展功能的决策
|
||||
|
||||
> **"去掉这个新功能点,原需求还能独立交付吗?"**
|
||||
> - 能 → 新建需求
|
||||
> - 不能 → 修改原需求(`/req edit`)
|
||||
|
||||
| 场景 | 建议 |
|
||||
|------|------|
|
||||
| 新功能是原需求的自然延伸 | 修改原需求 |
|
||||
| 新功能可独立上线 | 新建需求 |
|
||||
| 原需求已完成/归档 | 必须新建 |
|
||||
| 原需求开发中,新增会影响已有代码 | 新建(防范围蔓延) |
|
||||
|
||||
### 前后端拆分规则
|
||||
|
||||
```
|
||||
✅ 正确:
|
||||
REQ-001 用户积分规则管理-后端(含 CRUD 全部接口)
|
||||
REQ-002 用户积分规则管理-前端(含 CRUD 全部页面)
|
||||
|
||||
❌ 错误:
|
||||
REQ-001 用户积分规则-新增接口
|
||||
REQ-002 用户积分规则-查询接口
|
||||
REQ-003 用户积分规则-修改接口
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 用户故事编写
|
||||
|
||||
### 标准格式
|
||||
|
||||
Reference in New Issue
Block a user