name: journey-map description: “从引导的需求中创建客户旅程地图。可视化端到端的用户体验，包括阶段、接触点、情绪和痛点。输出 Mermaid 图表。” argument-hint: “[–domain <domain-name>] [–persona <persona-name>] [–format mermaid|yaml|markdown]” allowed-tools: Task, Read, Write, Glob, Grep, Skill
旅程地图命令
从引导的需求中创建客户旅程地图，可视化完整的用户体验。
用法
/requirements-elicitation:journey-map
/requirements-elicitation:journey-map --domain "onboarding"
/requirements-elicitation:journey-map --domain "checkout" --persona "first-time-buyer"
/requirements-elicitation:journey-map --domain "support" --format mermaid
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| –domain | 否 | 要映射的领域（默认：当前/最近） |
| –persona | 否 | 特定角色映射（默认：主要用户） |
| –format | 否 | 输出格式：mermaid、yaml、markdown（默认：mermaid） |
工作流程
步骤 1：加载合成需求
从 .requirements/{domain}/synthesis/ 和 .requirements/{domain}/interview/ 文件夹读取。
步骤 2：识别旅程阶段
从首次意识到完成后的端到端体验映射：
journey_stages:
awareness:
description: "用户意识到需求/问题"
questions:
- "什么触发用户开始？"
- "他们如何发现解决方案？"
consideration:
description: "用户评估选项"
questions:
- "他们考虑哪些替代方案？"
- "他们需要什么信息？"
acquisition:
description: "用户获得解决方案"
questions:
- "他们如何注册/购买？"
- "入门体验是什么？"
service:
description: "用户使用解决方案"
questions:
- "日常体验是什么？"
- "他们执行哪些任务？"
loyalty:
description: "用户成为回头客"
questions:
- "什么让他们回来？"
- "他们会推荐给别人吗？"
步骤 3：映射接触点
识别每个阶段的所有交互点：
touchpoint_types:
digital:
- 网站
- 移动应用
- 电子邮件
- 短信
human:
- 客户服务
- 销售
- 支持聊天
physical:
- 商店
- 包装
- 文档
步骤 4：捕捉情感旅程
记录每个阶段的用户情绪：
emotional_journey:
positive:
- 兴奋
- 自信
- 满意
- 高兴
neutral:
- 好奇
- 专注
- 等待
negative:
- 沮丧
- 困惑
- 焦虑
- 失望
步骤 5：识别痛点和机会
从需求和访谈中提取：
analysis:
pain_points:
- Source: 访谈转录，利益相关者投诉
- Location: 哪个阶段/接触点
- Severity: 关键，主要，次要
opportunities:
- 当前体验中的缺口
- 需求中的未满足需求
- 潜在的喜悦时刻
步骤 6：生成输出
以请求的格式创建旅程地图。
输出格式
Mermaid 图表（默认）
%%{init: {'theme': 'base'}}%%
journey
title 客户入门旅程
section 意识
在线发现产品: 5: 客户
阅读评论: 4: 客户
访问网站: 4: 客户
section 考虑
比较功能: 3: 客户
请求演示: 4: 客户, 销售
评估定价: 3: 客户
section 获取
注册试用: 4: 客户
完成入门: 3: 客户, 支持
首次购买: 5: 客户
section 服务
日常使用产品: 4: 客户
联系支持: 2: 客户, 支持
发现新功能: 5: 客户
section 忠诚
续订订阅: 5: 客户
推荐朋友: 5: 客户
替代：流程图样式
flowchart LR
subgraph Awareness["🔍 意识"]
A1["发现<br/>😊 好奇"]
A2["研究<br/>🤔 评估"]
end
subgraph Consideration["⚖️ 考虑"]
C1["比较<br/>😐 不确定"]
C2["演示<br/>😊 感兴趣"]
end
subgraph Acquisition["🛒 获取"]
Q1["注册<br/>😊 兴奋"]
Q2["入门<br/>😤 沮丧"]
Q3["首次使用<br/>😊 满意"]
end
subgraph Service["⚙️ 服务"]
S1["日常使用<br/>😊 自信"]
S2["支持<br/>😤 沮丧"]
end
subgraph Loyalty["❤️ 忠诚"]
L1["续订<br/>😊 忠诚"]
L2["推荐<br/>😍 倡导"]
end
A1 --> A2 --> C1 --> C2 --> Q1 --> Q2 --> Q3 --> S1 --> S2 --> L1 --> L2
style Q2 fill:#ffcdd2
style S2 fill:#ffcdd2
YAML 导出
journey_map:
title: "客户入门旅程"
domain: "onboarding"
persona: "first-time-user"
created: "2025-12-26"
stages:
- name: "意识"
emoji: "🔍"
touchpoints:
- name: "在线发现产品"
channel: "搜索 / 社交"
emotion: "好奇"
score: 5
- name: "阅读评论"
channel: "评论网站"
emotion: "评估"
score: 4
- name: "考虑"
emoji: "⚖️"
touchpoints:
- name: "比较功能"
channel: "网站"
emotion: "不确定"
score: 3
pain_point: "难以找到比较信息"
- name: "请求演示"
channel: "销售电话"
emotion: "感兴趣"
score: 4
- name: "获取"
emoji: "🛒"
touchpoints:
- name: "注册试用"
channel: "网站"
emotion: "兴奋"
score: 4
- name: "完成入门"
channel: "应用"
emotion: "沮丧"
score: 2
pain_point: "入门过于复杂，步骤太多"
opportunity: "简化为三步向导"
- name: "服务"
emoji: "⚙️"
touchpoints:
- name: "日常使用"
channel: "应用"
emotion: "自信"
score: 4
- name: "联系支持"
channel: "聊天 / 电子邮件"
emotion: "沮丧"
score: 2
pain_point: "等待时间过长，重复解释"
- name: "忠诚"
emoji: "❤️"
touchpoints:
- name: "续订订阅"
channel: "电子邮件 / 应用"
emotion: "忠诚"
score: 5
- name: "推荐朋友"
channel: "口碑"
emotion: "倡导"
score: 5
opportunity: "添加推荐奖励计划"
summary:
overall_score: 3.8
critical_pain_points:
- "入门复杂性"
- "支持等待时间"
key_opportunities:
- "简化入门向导"
- "添加自助服务支持"
- "实施推荐计划"
Markdown 导出
# 客户旅程地图：入门
**角色：** 首次用户
**领域：** 入门
**创建日期：** 2025-12-26
## 旅程概述
| 阶段 | 接触点 | 渠道 | 情绪 | 评分 |
|-------|------------|---------|---------|-------|
| 🔍 意识 | 在线发现 | 搜索 | 😊 好奇 | 5 |
| 🔍 意识 | 阅读评论 | 评论网站 | 🤔 评估 | 4 |
| ⚖️ 考虑 | 比较功能 | 网站 | 😐 不确定 | 3 |
| ⚖️ 考虑 | 请求演示 | 销售 | 😊 感兴趣 | 4 |
| 🛒 获取 | 注册 | 网站 | 😊 兴奋 | 4 |
| 🛒 获取 | 入门 | 应用 | 😤 **沮丧** | 2 |
| ⚙️ 服务 | 日常使用 | 应用 | 😊 自信 | 4 |
| ⚙️ 服务 | 联系支持 | 聊天 | 😤 **沮丧** | 2 |
| ❤️ 忠诚 | 续订 | 应用 | 😊 忠诚 | 5 |
| ❤️ 忠诚 | 推荐朋友 | 口碑 | 😍 倡导 | 5 |
## 情感旅程曲线
```text
😍 | *
😊 | * * * * *
😐 | *
😤 | * *
+-------------------------------------------------->
意识 研究 比较 演示 注册 入门 使用 支持 续订 推荐
痛点
关键
-
入门复杂性（评分：2）
- 阶段：获取
- 问题：步骤太多，流程混乱
- 建议：简化为三步向导
-
支持等待时间（评分：2）
- 阶段：服务
- 问题：等待时间长，重复解释
- 建议：添加自助服务选项
机会
- 简化入门 - 高影响，解决关键痛点
- 自助服务支持 - 减少沮丧，降低成本
- 推荐计划 - 利用倡导阶段
示例会话
/requirements-elicitation:journey-map --domain "e-commerce" --persona "mobile-shopper"
加载合成： .requirements/e-commerce/synthesis/SYN-20251226-150000.yaml
加载访谈： .requirements/e-commerce/interview/*.yaml
角色： 移动购物者
- 主要设备： 智能手机
- 购物频率： 每周
- 关键动机： 便利，快速结账
识别旅程阶段...
✓ 意识（3 个接触点）
✓ 考虑（4 个接触点）
✓ 获取（5 个接触点）
✓ 服务（3 个接触点）
✓ 忠诚（2 个接触点）
映射情感旅程...
关键痛点识别：2
- 移动结账流程（评分：2）
- 小屏幕上的产品搜索（评分：3）
喜悦时刻识别：3
- 快速重新下单功能（评分：5）
- 订单跟踪通知（评分：5）
- 一键结账（评分：5）
生成 Mermaid 图表...
[Mermaid 图表输出]
保存到： .requirements/e-commerce/journey-map/
- journey-map-mobile-shopper.mmd
- journey-map-mobile-shopper.yaml
输出位置
output_locations:
mermaid: ".requirements/{domain}/journey-map/journey-map[-{persona}].mmd"
yaml: ".requirements/{domain}/journey-map/journey-map[-{persona}].yaml"
markdown: ".requirements/{domain}/journey-map/journey-map[-{persona}].md"
与其他命令集成
模拟后
# 模拟利益相关者视角
/requirements-elicitation:simulate --domain "onboarding" --personas end-user
# 从模拟洞察创建旅程地图
/requirements-elicitation:journey-map --domain "onboarding"
结合故事映射
# 创建两种视图以全面理解
/requirements-elicitation:journey-map --domain "checkout"
/requirements-elicitation:story-map --domain "checkout"
# 旅程地图 = 情感体验视图
# 故事地图 = 交付/发布规划视图
委托
此命令委托给 journey-mapper 代理进行复杂的旅程分析和可视化生成。
错误处理
error_handling:
no_synthesis:
message: "未找到领域的合成需求"
action: "首先运行 /discover 以引导需求"
no_persona_data:
message: "无角色信息可用"
action: "继续使用通用'用户'角色或首先运行 /simulate"
insufficient_touchpoints:
message: "接触点太少，无法生成有意义的旅程地图"
action: "添加更多需求或访谈数据"