pm-pool

name	pm-pool
description	Use when: 有新需求需要录入跟踪、需求状态需要变更、需要统一管理需求池、需求数量增多需要结构化 Do NOT use when: 需求极少可直接管理、仅需一次性分析无需持续跟踪
allowed-tools	["Read","Write","Edit","AskUserQuestion","Bash"]

Preamble (run first)

bash "$(dirname "${BASH_SOURCE[0]}")/../../check-update.sh" 2>/dev/null || true
# 创建需求调研目录
mkdir -p docs/01-需求调研

# 检查是否有需求池
if [ ! -f "docs/01-需求调研/需求池管理表.md" ]; then
  echo "⚠️  未找到需求池管理表"
  echo ""
  echo "将创建新的需求池"
fi

---

跨 Agent 交互规则

当流程要求与用户交互时：

1. 如果当前环境支持 AskUserQuestion，使用 AskUserQuestion（最佳体验）。
2. 如果当前环境不支持 AskUserQuestion，必须用普通聊天消息提出同样问题。
3. 一次只问一个问题。
4. 提问后必须停止当前回合，等待用户回答（STOP and WAIT）。
5. 不得在用户回答前生成文档、写入 docs。
6. 已有 docs 文件不能替代本轮用户回答。

---

执行流程

步骤 1: 选择操作

使用 AskUserQuestion 询问：

🎯 您要对需求池进行什么操作？

A) 添加新需求 B) 查看需求池 C) 更新需求状态 D) 删除需求 E) 导出需求池

---

步骤 2: 执行操作

---

操作 A: 添加新需求

使用 AskUserQuestion 逐个询问：

问题 1: 需求名称

请输入需求名称：

例如："用户登录"、"搜索功能"

---

问题 2: 需求类型

需求类型是什么？

A) 新功能 B) 功能优化 C) Bug修复 D) 技术债务 E) 其他

---

问题 3: 优先级

需求优先级？

A) P0 - 紧急重要 B) P1 - 重要不紧急 C) P2 - 紧急不重要 D) P3 - 不紧急不重要

---

问题 4: 来源

需求来源？

A) 用户反馈 B) 业务部门 C) 产品规划 D) 竞品分析 E) 其他（请手动输入）

---

问题 5: 描述

请详细描述需求：

包括背景、目标、验收标准等

---

AI 将需求信息添加到需求池管理表。

---

操作 B: 查看需求池

读取 docs/01-需求调研/需求池管理表.md，格式化输出：

📋 需求池概览

需求总数: {N}个 P0: {N}个 P1: {N}个 P2: {N}个 P3: {N}个

按状态分类:

• 待评估: {N}个
• 已规划: {N}个
• 开发中: {N}个
• 已完成: {N}个

查看详情？

---

操作 C: 更新需求状态

列出所有需求，让用户选择要更新的需求：

请选择要更新的需求：

A) {需求1} - 当前状态: 待评估 B) {需求2} - 当前状态: 已规划 C) {需求3} - 当前状态: 开发中 ...

用户选择后，询问新状态：

新状态是什么？

A) 待评估 B) 已规划 C) 开发中 D) 测试中 E) 已上线 F) 已关闭

更新需求池管理表。

---

操作 D: 删除需求

列出所有需求，让用户选择要删除的需求：

请选择要删除的需求：

A) {需求1} B) {需求2} ...

确认后删除。

---

操作 E: 导出需求池

生成可分享的需求池文档：

选择导出格式：

A) Markdown B) CSV C) JSON

---

步骤 3: 更新需求池管理表

如果需求池管理表不存在，使用 Write 创建：

# 需求池管理表

## 一、需求概览

- **需求总数**: {N}个
- **更新时间**: {当前时间}

---

## 二、需求列表

| ID | 需求名称 | 类型 | 优先级 | 状态 | 来源 | 创建时间 |
|----|----------|------|--------|------|------|----------|
| R001 | {需求1} | {类型} | {优先级} | {状态} | {来源} | {时间} |
| R002 | {需求2} | {类型} | {优先级} | {状态} | {来源} | {时间} |

---

## 三、需求详情

### R001: {需求名称}

**类型**: {类型}

**优先级**: {优先级}

**状态**: {状态}

**来源**: {来源}

**描述**:
{详细描述}

**验收标准**:
- {标准1}
- {标准2}

**负责人**: {负责人}

**预计完成时间**: {时间}

---

## 四、统计信息

### 4.1 按优先级

- P0: {N}个
- P1: {N}个
- P2: {N}个
- P3: {N}个

### 4.2 按状态

- 待评估: {N}个
- 已规划: {N}个
- 开发中: {N}个
- 已上线: {N}个

---

**最后更新**: {时间戳}
**生成工具**: super-pm

如果需求池已存在，使用 Edit 更新。

---

步骤 4: 输出完成提示

使用 AskUserQuestion：

✅ 需求池已更新！

📄 需求池管理表：docs/01-需求调研/需求池管理表.md

🎯 下一步：

A) 继续管理需求池 B) 执行 /pm-priority - 对需求排序 C) 执行 /pm-mvp - 规划MVP D) 查看需求池

---

兜底机制

场景 1: 需求池不存在

自动创建新的需求池。

场景 2: 需求数量过多

提供筛选和搜索功能。

---

注意事项

1. 唯一ID：每个需求分配唯一ID（R001, R002...）
2. 状态流转：记录状态变更历史
3. 优先级可调整：根据业务变化调整
4. Markdown存储：需求池人类可读可编辑
5. 定期清理：建议定期清理已完成需求

---

输出质量对比

✅ Good 示例：

- 有数据引用：「根据 Q4 数据，留存率从 35% 降至 28%」
- 有验证来源：「数据来源：Google Analytics, 2025-12-01」
- 有明确建议：「建议将新手引导步骤从 5 步减少至 3 步」

❌ Bad 示例：

- 模糊结论：「数据表明留存率有所下降」
- 无来源：「根据经验，这个功能很重要」
- 没有行动建议：「留存是个问题」

---

常见误区 / Red Flags — STOP

出现以下情况立即停止并回溯：

误区	正确做法
使用"应该"、"大概"、"看起来"做结论	必须基于实际数据和验证
未运行检查就声称已完成	先验证，再陈述
因时间紧迫跳过关键步骤	没有例外，时间紧更要严格
"这次应该没问题"的想法	每次都要重新验证

---

产出质量检查 / Verification Checklist

• 前置依赖已满足（输入文档/数据已收集）
• 核心步骤已全部执行
• 输出文档已生成到 docs/ 目录
• 每个判断都有数据/证据支撑
• 已推荐 2-3 个后续 skill

⚠️ 任何一项未通过 → 补全后再标记完成。

---