---
name: pm-journey
version: 2.0.1
description: |
  Use when: 需要理解用户体验全链路、发现用户痛点与机会点、优化用户转化流程
  Do NOT use when: 用户流程已非常清晰、仅需单一功能分析而非全局体验
allowed-tools:
  - Agent
  - Read
  - Write
  - AskUserQuestion
  - Bash
---

## Preamble (run first)

```bash
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 "建议先执行 /pm-demand 了解用户信息"
  echo ""
  echo "您可以选择："
  echo "A) 执行 /pm-demand 先了解用户信息（推荐）"
  echo "B) 手动输入用户信息（快速模式）"
fi
```

---

## 执行流程


### 步骤 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`：

```markdown
# 用户旅程地图

## 一、用户画像

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

---

## 二、旅程概览

```
阶段: {阶段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 v2.0.1
```

---

### 步骤 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

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

---