generate-research-deliverablelisted
Install: claude install-skill ayouaiyouwei-arch/claude_pm_workflows
> 🔧 项目无关骨架版 · 项目专属配置见 PROJECT-PROFILE.md
# Skill · generate-research-deliverable
> 一句话定位:产品 PM 起新需求/优化时调用。从 `_template/` 复制一份带时间戳 + CHG 编号 + 状态后缀的交付包,并按输入参数预填 02 / 03 / 04 / 05 / 99,PM 后续只需补完 01 / 03 / 06。**产出的包初始为 `.draft`,需要后续�� `promote-deliverable` 升 `.active` 才能给 Codex 干活。**
## 触发条件
- 产品 PM 提出新需求或优化(已登记 `CHG-XXX`)
- 用户明确要求「起一个研发交付包」「为 CHG-XXX 起包」「派活给 Codex 之前先打个包」
- 验收不通过且决定 `.superseded` 重做时(起一个新包,引用旧包)
## 输入
| 输入 | 是否必填 | 示例 / 默认 |
|---|---|---|
| CHG 编号 | ✅ | `<CHG-XXX>` |
| 中文短名(≤ 12 字) | ✅ | `<模块名>闭环` |
| 创建日期 | 默认今日 | `<YYYY-MM-DD>` |
| 关联 DIFF(多条) | 选填 | `<DIFF-XXX>` |
| 关联模块(test 内目录名) | ✅ | `<模块名>` |
| 修改白名单 glob 列表 | ✅ | `code/<仓库名>/<前端包>/src/pages/<模块>/**`(端结构见 PROJECT-PROFILE.md § 五) |
| 修改黑名单 glob 列表 | 默认套通用集 | 见模板 |
| 必过用例 case_id 列表 | ✅ | `<MOD>-001, <MOD>-002, ...` |
| **【M1.8 D2 新增】本期作废 case_id 列表** | 选填 | `<MOD>-XYZ`(snapshot 里有但本期取消) |
| **【M1.8 D2 新增】本期修改 case_id 列表** | 选填 | `<MOD>-ABC=固定60%不可拖` |
| 截止日期 | ✅ | `<YYYY-MM-DD>` |
| 指派 owner | ✅ | `Codex` / 研发姓名 |
## 前置校验(执行前自检)
1. **CHG 已登记**:`grep "<CHG-XXX>" product-docs/ai-page-interaction-audit/baseline/03-产品变更登记.md` 命中
2. **包名不冲突**:`ls deliverables/` 不存在同名目录(含其他状态后缀)
3. **当前 `.active` 包数 ≤ 1**:本 skill 只产 `.draft`,不影响 active 计数;但如已经 ≥ 1 active,提醒 PM「起完 draft 后不能立刻 active」
## 步骤
1. **拷贝模板**
```bash
cp -R deliverables/_template deliverables/<YYYY-MM-DD>-<CHG-XXX>-<中文短名>.draft
```
- 拷贝完成后,删除包内 `test-cases-snapshot/.gitkeep`(步骤 4.5 会用真 CSV 填充)
1.5 **【M1.8 D1 新增】沿用包内 `AGENTS.md`**