AgentSkillsCN

ux-journey-mapper

将 UI 截图与流程描述转化为用户旅程地图,标注触点、情绪、痛点与机遇。适用于记录用户体验、识别情绪的高潮与低谷、创建旅程文档,或当用户提及“旅程地图”、“用户旅程”、“触点”、“痛点”、“情绪旅程”或“体验地图”时使用。

SKILL.md
--- frontmatter
name: ux-journey-mapper
description: Convert UI screenshots and flow descriptions into user journey maps with touchpoints, emotions, pain points, and opportunities. Use when documenting user experiences, identifying emotional highs and lows, creating journey documentation, or when user mentions "journey map", "user journey", "touchpoints", "pain points", "emotional journey", or "experience map".

UX Journey Mapper

Transform screen flows into comprehensive journey maps with emotional and experiential insights.

Journey Map Components

1. Stages

High-level phases of the experience:

  • Awareness → Consideration → Decision → Use → Advocacy

Or task-specific:

  • Start → Configure → Execute → Review → Complete

2. Touchpoints

Specific screens, features, or interactions within each stage.

3. User Actions

What the user does at each touchpoint.

4. Thoughts & Questions

What users are thinking or wondering.

5. Emotions

Emotional state (positive, neutral, negative) with intensity.

6. Pain Points

Friction, confusion, or frustration sources.

7. Opportunities

Improvements that would enhance the experience.

Mapping Process

  1. Define the journey scope - Start and end points, user goal
  2. Identify stages - Break into 3-6 major phases
  3. List touchpoints - Each screen/interaction per stage
  4. Document actions - What user does at each point
  5. Infer emotions - Based on UX quality at each point
  6. Note pain points - Friction observed
  7. Spot opportunities - Potential improvements

Emotion Assessment

Positive Indicators

  • Clear next steps
  • Quick task completion
  • Helpful feedback
  • Successful outcomes

Neutral Indicators

  • Standard interactions
  • Expected behavior
  • No surprises (good or bad)

Negative Indicators

  • Confusion about next step
  • Excessive clicks/time
  • Error states
  • Missing information
  • Dead ends

Output Format: Text Journey Map

code
# User Journey: [Goal/Task Name]

**User:** [Persona or role]
**Goal:** [What user is trying to accomplish]
**Scenario:** [Context/situation]

---

## Stage 1: [Stage Name]

### Touchpoint 1.1: [Screen/Feature]
- **Action:** [What user does]
- **Thought:** "[What user is thinking]"
- **Emotion:** 😊 Positive / 😐 Neutral / 😟 Negative
- **Pain point:** [If any]
- **Opportunity:** [If any]

### Touchpoint 1.2: [Screen/Feature]
...

---

## Stage 2: [Stage Name]
...

---

## Journey Summary

### Emotional Arc
[Stage 1] 😊 → [Stage 2] 😐 → [Stage 3] 😟 → [Stage 4] 😊

### Key Pain Points
1. [Pain point with stage reference]
2. [Pain point with stage reference]

### Top Opportunities
1. [Opportunity with expected impact]
2. [Opportunity with expected impact]

### Moments of Delight
1. [Positive moment to preserve/amplify]

Output Format: Visual Journey Map (ASCII)

code
Journey: [Goal]
User: [Persona]

STAGE      | Awareness    | Setup        | Execution    | Completion
-----------|--------------|--------------|--------------|-------------
Touchpoint | Landing page | Config form  | Run wizard   | Success page
Action     | Read intro   | Fill fields  | Click next   | Review result
Emotion    | 😐 Curious   | 😟 Confused  | 😐 Patient   | 😊 Relieved
Pain Point | —            | Too many     | Slow load    | —
           |              | options      |              |
Opportunity| Add video    | Smart        | Progress     | Share option
           | demo         | defaults     | indicator    |

Emotion Curve:
     😊 |                                              ★
     😐 | ★                           ★
     😟 |              ★
        |____________________________________________
          Aware    Setup    Execute    Complete

Common Journey Patterns

The Valley of Despair

High initial excitement, deep frustration in middle, recovery at end.

  • Fix: Improve middle stages, add encouragement

The Slow Burn

Gradual decline in satisfaction over time.

  • Fix: Add delight moments, reduce cumulative friction

The Cliff

Sudden drop in experience at specific point.

  • Fix: Focus on that specific touchpoint

The Plateau

Neutral throughout, no highs or lows.

  • Fix: Add moments of delight, reduce to essentials

Pain Point Categories

CategorySymptomsExample
Confusion"Where do I go?"Unclear navigation
Frustration"This takes too long"Excessive steps
Anxiety"Did it work?"No feedback
Disappointment"I expected more"Unmet expectations
AbandonmentUser leavesCritical failure

References

For journey mapping templates: See references/journey-templates.md