Pm journey

Preamble (run first)

bash "$(dirname "${BASH_SOURCE[0]}")"/check-update.sh 2>/dev/null || true
# 读取技能包版本号
SKILL_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)" || true
if [ -f "$SKILL_ROOT/VERSION" ]; then echo "📦 super-pm $(cat "$SKILL_ROOT/VERSION")"; fi
# 创建需求调研目录
mkdir -p docs/01-需求调研

# 检查是否有需求调研报告
if [ ! -f "docs/01-需求调研/需求调研报告.md" ]; then
  echo "⚠️  未找到需求调研报告"
  echo ""
  echo "建议先执行 /pm-demand 了解用户信息"
  echo ""
  echo "您可以选择："
  echo "A) 执行 /pm-demand 先了解用户信息（推荐）"
  echo "B) 手动输入用户信息（快速模式）"
fi

---

跨 Agent 交互规则

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

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

---

执行流程

步骤 1: 读取前置数据

使用 Read 工具读取：

• docs/01-需求调研/需求调研报告.md（提取目标用户）
• docs/01-需求调研/MVP方案.md（提取核心功能，如有）

---

步骤 2: 确定用户类型

使用 AskUserQuestion：

🎯 绘制哪类用户的旅程？

A) 新用户 - 首次使用产品的用户 B) 活跃用户 - 经常使用产品的用户 C) 流失用户 - 曾经活跃但已停止使用的用户 D) 付费用户 - 已付费的用户 E) 其他（请手动输入）

---

步骤 3: 确定旅程场景

用户要完成什么任务？

A) 核心任务 - 产品主要功能（如购买、下单） B) 入门任务 - 新用户引导流程 C) 探索任务 - 发现新功能 D) 问题解决 - 寻求帮助或解决问题 E) 其他（请手动输入）

---

步骤 4: 绘制用户旅程

AI 引导用户拆解旅程阶段：

问题 1: 旅程阶段

用户完成任务经历哪些阶段？

例如："发现产品 → 注册 → 首次使用 → 深度使用 → 推荐分享"

请输入各个阶段（每行一个阶段）：

用户输入后，记录到列表 JOURNEY_STAGES

---

问题 2: 每个阶段的详细分析

对每个阶段，AI 询问：

阶段: {阶段名称}

问题 2.1: 用户行为

在"{阶段名称}"阶段，用户具体做什么？

例如："搜索关键词"、"浏览商品列表"、"对比价格"

请描述用户行为：

---

问题 2.2: 触点

用户通过什么渠道/入口进入这个阶段？

A) 移动APP B) 网页端 C) 小程序 D) 第三方平台 E) 其他（请手动输入）

---

问题 2.3: 用户情绪

在这个阶段，用户的情绪如何？

A) 期待兴奋 😊 B) 平静专注 😐 C) 困惑焦虑 😕 D) 挫败不满 😠 E) 满意愉悦 😄

记录到变量 USER_EMOTION

---

问题 2.4: 痛点

在这个阶段，用户可能遇到什么问题？

A) 操作复杂 - 步骤太多 B) 信息不清晰 - 不知道该做什么 C) 等待时间过长 D) 功能缺失 E) 无明显痛点

如果用户选择具体痛点，询问：

这个痛点有多严重？

A) 轻微 - 用户可以忍受 B) 中等 - 影响体验 C) 严重 - 可能导致用户流失

---

问题 2.5: 机会点

针对这个阶段的痛点，有什么改进机会？

请描述您的想法：

---

步骤 5: 绘制情绪曲线

AI 根据用户输入，绘制情绪曲线：

情绪值
  5 |        😄
  4 |   😊              😄
  3 |        😐
  2 |             😕
  1 |                  😠
  0 +------------------------
     发   注   首   深   推
     现   册   次   度   荐
          使   使   分
          用   用   享

---

步骤 6: 生成用户旅程地图

使用 Write 工具创建 docs/01-需求调研/用户旅程地图.md：

# 用户旅程地图

## 一、用户画像

- **用户类型**: {用户类型}
- **任务场景**: {任务场景}
- **生成时间**: {当前时间}

---

## 二、旅程概览

阶段: {阶段1} → {阶段2} → {阶段3} → {阶段4} → {阶段5}

---

## 三、详细旅程分析

### 阶段 1: {阶段名称}

**用户行为**:
- {行为1}
- {行为2}

**触点**:
- {触点1}
- {触点2}

**用户情绪**: {情绪} {emoji}

**痛点**:
- {痛点1}（严重程度：{程度}）
- {痛点2}

**机会点**:
- {机会1}
- {机会2}

---

### 阶段 2: {阶段名称}

**用户行为**:
- {行为1}

**触点**:
- {触点1}

**用户情绪**: {情绪} {emoji}

**痛点**:
- {痛点1}

**机会点**:
- {机会1}

---

## 四、情绪曲线

情绪值 5 | 😄 4 | 😊 😄 3 | 😐 2 | 😕 1 | 😠 0 +------------------------ {阶段1} {阶段2} {阶段3} {阶段4} {阶段5}

---

## 五、痛点汇总

| 阶段 | 痛点 | 严重程度 | 影响 |
|------|------|----------|------|
| {阶段1} | {痛点} | {程度} | {影响} |
| {阶段2} | {痛点} | {程度} | {影响} |

---

## 六、机会点汇总

| 阶段 | 机会点 | 预期效果 | 优先级 |
|------|--------|----------|--------|
| {阶段1} | {机会} | {效果} | P0 |
| {阶段2} | {机会} | {效果} | P1 |

---

## 七、改进建议

### 7.1 短期优化（1-2周）

1. {建议1}
2. {建议2}

### 7.2 中期优化（1-2月）

1. {建议1}
2. {建议2}

### 7.3 长期规划（3-6月）

1. {建议1}

---

## 八、下一步建议

建议执行：

1. **/pm-docs** - 生成PRD文档（推荐）
2. **/pm-proto** - 原型设计
3. **/pm-priority** - 对改进机会排序

---

**项目状态**: 用户旅程地图完成
**生成时间**: {时间戳}
**生成工具**: super-pm

---

步骤 7: 输出完成提示

使用 AskUserQuestion：

✅ 用户旅程地图完成！

📄 用户旅程地图已生成：docs/01-需求调研/用户旅程地图.md

🎯 建议下一步：

A) 执行 /pm-docs - 生成PRD文档（推荐） B) 执行 /pm-proto - 原型设计 C) 执行 /pm-priority - 对改进机会排序 D) 查看用户旅程地图

---

兜底机制

场景 1: 无需求数据

提供快速模式，手动输入用户信息。

场景 2: 阶段过多

如果阶段 > 7，提醒用户简化：

⚠️ 阶段较多（{N}个），建议聚焦核心阶段

您可以选择： A) 保留所有阶段 B) 仅分析核心阶段

---

注意事项

1. 用户视角：始终从用户角度描述行为和情绪
2. 痛点具体：避免泛泛而谈，要具体可操作
3. 情绪曲线：直观展示用户体验变化
4. 机会可落地：改进建议要可执行
5. Markdown存储：旅程地图人类可读可编辑

---

输出质量对比

✅ Good 示例：

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

❌ Bad 示例：

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

---

常见误区 / Red Flags — STOP

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

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

---

产出质量检查 / Verification Checklist

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

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

---