pm-docs

Preamble (run first)

bash "$(dirname "${BASH_SOURCE[0]}")/../../check-update.sh" 2>/dev/null || true
# 创建方案设计目录
mkdir -p docs/02-方案设计

# 检查前置文档
echo "📊 正在检查前置文档..."

if [ -f "docs/01-需求调研/MVP方案.md" ]; then
  echo "✅ MVP方案 - 已找到"
else
  echo "⏳ MVP方案 - 未找到"
fi

if [ -f "docs/01-需求调研/需求调研报告.md" ]; then
  echo "✅ 需求调研报告 - 已找到"
else
  echo "⏳ 需求调研报告 - 未找到"
fi

if [ -f "docs/01-需求调研/市场调研报告.md" ]; then
  echo "✅ 市场调研报告 - 已找到"
else
  echo "⏳ 市场调研报告 - 未找到"
fi

---

前置门禁

无论从哪个入口进入，都必须执行前置文档检查：

1. 检查 docs/01-需求调研/ 中是否有 MVP方案（黄金路径的必要前置）
2. 如果有 MVP方案 → 读取文档，判断是否与当前用户描述的产品相关
   • 相关 → 前置已满足，继续执行
   • 不相关 → 停止，建议先完成前置流程
3. 如果没有 MVP方案 → 停止，建议先执行 /pm-brainstorm → /pm-demand → /pm-mvp

不得在门禁不满足时生成文档。

---

跨 Agent 交互规则

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

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

---

执行流程

步骤 1: 确定文档类型（主 agent - 用户交互）

使用 AskUserQuestion 询问：

您希望生成哪些文档？

A) 仅 PRD - 产品需求文档 B) 仅 BRD - 商业需求文档 C) 仅 MRD - 市场需求文档 D) PRD + BRD + MRD（全套文档，推荐） E) 让我推荐（根据项目状态自动选择）

💡 提示：选择"D"可并行生成全套文档，效率提升 3x

用户选择后，记录到变量 DOC_TYPES（数组）

---

步骤 2: 读取前置数据（主 agent）

读取所有可能需要的前置文档：

# 主 agent 一次性读取所有前置文档
required_docs=(
  "docs/01-需求调研/MVP方案.md"
  "docs/01-需求调研/需求调研报告.md"
  "docs/01-需求调研/市场调研报告.md"
  "docs/01-需求调研/确认需求清单.md"
  "docs/01-需求调研/优先级排序报告.md"
)

for doc in "${required_docs[@]}"; do
  if [ -f "$doc" ]; then
    # 使用 Read 工具读取
    echo "读取 $doc"
  fi
done

构建上下文摘要（避免占用大量上下文）：

提取关键信息：

• 产品名称
• 目标用户
• 核心功能
• MVP范围
• 市场数据
• 商业目标

将关键信息存储为结构化数据，准备传递给 subagent。

---

步骤 3: 并行派发 subagent 生成文档（核心优化）

优化说明：

• 主 agent 一次性派发多个 subagent
• 每个 subagent 负责生成一个文档
• 文档生成细节不占用主 agent 上下文
• 所有文档并行生成

---

3.1 构建 subagent 任务

如果用户选择"全套文档"：

准备 3 个并行 subagent 任务：

[
  {
    "task_id": "generate_prd",
    "doc_type": "PRD",
    "required_data": [
      "产品名称",
      "目标用户",
      "MVP功能列表",
      "用户需求",
      "优先级排序"
    ]
  },
  {
    "task_id": "generate_brd",
    "doc_type": "BRD",
    "required_data": [
      "产品名称",
      "商业模式",
      "市场数据",
      "成本分析",
      "盈利预测"
    ]
  },
  {
    "task_id": "generate_mrd",
    "doc_type": "MRD",
    "required_data": [
      "产品名称",
      "市场调研数据",
      "用户画像",
      "竞品分析",
      "市场机会"
    ]
  }
]