/pm-journey

name: pm-journey
description: |
  Use when: 需要理解用户体验全链路、发现用户痛点与机会点、优化用户转化流程
  Do NOT use when: 用户流程已非常清晰、仅需单一功能分析而非全局体验
allowed-tools:
  - Agent
  - Read
  - Write
  - 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 "建议先执行 /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

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

---