Token导航 LogoToken导航TokenDH.com
研究检索需要联网github未标认证来源可访问许可证需确认审计通过

story-mapping故事映射

Agent Skill

story-mapping 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

447

周安装

19

GitHub Stars

103

下载量

157
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:story-mapping(故事映射)
来源仓库:https://github.com/borghei/claude-skills
仓库路径:skills/story-mapping
安装命令:
npx skills add https://github.com/borghei/claude-skills --skill story-mapping
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/borghei/claude-skills --skill story-mapping

简介

story-mapping 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中快速定位内容。

  • 适用于基于关键词或任务场景从来源线索中提取信息的场景。
  • 通过 npx skills add 命令安装,需结合原始 README 确认使用方法。
  • 安装前建议核实权限范围、维护状态及是否涉及联网或文件操作。
  • 可参考来源仓库进一步验证功能细节。

SKILL.md

User Story Mapping Expert

Overview

Visualize the user journey and translate strategy into prioritized, deliverable work using Jeff Patton's user story mapping technique. Story maps shift teams from feature-first thinking to flow-first thinking -- understanding the complete user experience before deciding what to build and in what order.

When to Use

  • MVP definition -- When you need to draw a clear line between "must ship" and "can wait."
  • Release planning -- When sequencing work across multiple releases or sprints.
  • Cross-team alignment -- When multiple teams need a shared understanding of the user journey.
  • Backlog reorganization -- When a flat backlog has lost context and priority clarity.
  • New product kickoff -- When starting from scratch and need to decompose a vision into work.

When NOT to Use

  • When work is purely technical infrastructure with no user journey (use technical spikes instead).
  • When the team already has a well-prioritized, context-rich backlog.
  • For single-feature work that doesn't span multiple user activities.

Story Map Anatomy

A story map has three layers arranged in a 2D grid:

                    USER JOURNEY (left to right) →

    ┌──────────────────────────────────────────────────┐
    │  Activities    Activity 1    Activity 2    Act 3  │  ← Backbone
    ├──────────────────────────────────────────────────┤
    │  Steps         Step 1.1      Step 2.1     Step   │  ← Backbone
    │                Step 1.2      Step 2.2      3.1   │
    ├──────────────────────────────────────────────────┤
    │  Tasks         Task A        Task D       Task G │  ← Body
    │  (Release 1)   Task B        Task E              │  ← MVP line
    │  ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │
    │  Tasks         Task C        Task F       Task H │  ← Body
    │  (Release 2)                                     │  ← Follow-up
    └──────────────────────────────────────────────────┘

    PRIORITY (top to bottom) ↓
LayerWhat It ContainsGranularity
ActivitiesHigh-level user goals (what are they trying to accomplish?)Epic-level
StepsSequential actions within each activityFeature-level
TasksSpecific implementation items for each stepStory-level

Key Principle: Flow First, Then Priority

  • Horizontal axis (left to right): The user's journey through time -- activities and steps in the order users experience them.
  • Vertical axis (top to bottom): Priority -- most critical tasks at the top, nice-to-haves at the bottom.
  • MVP line: A horizontal line drawn across the map separating "Release 1" from "Later."

Building a Story Map

Step 1: Define Who and What

ElementDescription
SegmentThe target user segment for this map
PersonaThe specific persona experiencing this journey
Narrative/JTBDThe job or goal the user is trying to accomplish
DecisionWhat this map should inform (MVP scope, release plan, sequencing)

Step 2: Map the Backbone (Activities)

Walk through the user's journey and identify 3-7 high-level activities:

#### Activities:
1. [Discover the product]
2. [Sign up and onboard]
3. [Complete core task]
4. [Review results]
5. [Share with team]

Tips:

  • Use active verbs ("Discover," "Configure," "Review") not nouns.
  • Keep to 3-7 activities -- more means you need to zoom out.
  • Arrange left to right in the order users experience them.

Step 3: Break Activities into Steps

For each activity, identify 3-5 sequential steps:

#### Steps for "Sign up and onboard":
- Step 1: Create account
- Step 2: Verify email
- Step 3: Set up profile
- Step 4: Complete tutorial
- Step 5: Invite team members

Step 4: Decompose Steps into Tasks

For each step, list specific implementation tasks:

#### Tasks for "Create account":
- Email/password registration
- Social login (Google, GitHub)
- SSO integration
- Terms acceptance
- Password strength validation

Step 5: Prioritize Vertically

Arrange tasks within each column from top (highest priority) to bottom (lowest):

  • Top: Must-have for the journey to work at all.
  • Middle: Important for a good experience.
  • Bottom: Nice-to-have, can defer.

Step 6: Draw Release Lines

Draw horizontal lines across the map to define releases:

═══════════════════════════ Release 1 (MVP) ═══════════
- Email/password registration
- Verify email
- Basic profile setup
- Core task (minimal)
- View results

═══════════════════════════ Release 2 ═══════════════════
- Social login
- Team invitations
- Advanced tutorial
- Share results
- Export results

═══════════════════════════ Release 3 (Polish) ══════════
- SSO integration
- Custom branding
- Advanced analytics
- API access

Story Map Template

## User Story Map

### Context
- **Segment:** [Target segment]
- **Persona:** [Persona name and key characteristics]
- **Narrative:** [The job or goal being mapped]
- **Decision:** [What this map informs]

### Backbone

#### Activities:
1. [Activity 1]
2. [Activity 2]
3. [Activity 3]
4. [Activity 4]
5. [Activity 5]

#### Steps:
**[Activity 1]:**
- Step 1: [Description]
- Step 2: [Description]
- Step 3: [Description]

**[Activity 2]:**
- Step 1: [Description]
- Step 2: [Description]
- Step 3: [Description]

[Continue for each activity]

#### Tasks:
**[Activity 1, Step 1]:**
- Task 1: [Description]
- Task 2: [Description]
- Task 3: [Description]

[Continue for each step]

### Release Slices

**Release 1 (MVP):**
- [Task list -- minimum viable journey]

**Release 2:**
- [Task list -- improved experience]

**Release 3:**
- [Task list -- full vision]

### Assumptions to Validate
- [Assumption 1]
- [Assumption 2]
- [Assumption 3]

### Risks and Dependencies
- [Risk or dependency 1]
- [Risk or dependency 2]

Common Story Map Patterns

Pattern 1: Walking Skeleton

Map the thinnest possible end-to-end journey first:

Activity 1 → Activity 2 → Activity 3 → Activity 4
    ↓             ↓             ↓             ↓
  1 task        1 task        1 task        1 task

One task per activity, proving the full flow works. Then add depth.

Pattern 2: Thick Slice

When one activity is the core value, go deep there first:

Activity 1 → Activity 2 → Activity 3 → Activity 4
    ↓             ↓             ↓             ↓
  1 task        5 tasks       1 task        1 task
                (core)

Pattern 3: Progressive Enhancement

Layer capabilities across releases:

Release 1:  Basic flow    (all activities, minimum tasks)
Release 2:  Error handling (edge cases, validation)
Release 3:  Power features (automation, customization)
Release 4:  Scale          (performance, enterprise)

Facilitation Guide

Running a Story Mapping Workshop

PhaseDurationActivity
Setup10 minDefine persona, narrative, and decision scope
Backbone20 minMap activities and steps (sticky notes on wall or Miro)
Body30 minDecompose into tasks (everyone contributes)
Prioritize15 minArrange vertically by priority
Slice15 minDraw release lines; debate MVP scope
Review10 minIdentify risks, dependencies, and assumptions

Total: ~100 minutes for a focused session.

Materials: Sticky notes (3 colors: activities, steps, tasks), markers, large wall or whiteboard, or Miro/FigJam for remote.

Key facilitation rules:

  • Keep each sticky note to 4-8 words.
  • Activities and steps first; resist jumping to tasks.
  • Everyone writes, not just the PM.
  • Debate the MVP line, not individual task priority.

Integration with Other Skills

  • Use job-stories/ JTBD discovery canvas to define the narrative before mapping.
  • Feed Release 1 tasks into create-prd/ for detailed requirements.
  • Use prioritization-frameworks/ RICE scoring to prioritize within release slices.
  • Use brainstorm-okrs/ to align release slices with quarterly objectives.
  • Convert tasks into user stories or job stories using job-stories/ or wwas/.

Troubleshooting

ProblemLikely CauseResolution
Map has 10+ activitiesScope too broad; multiple journeys mapped as oneSplit into separate maps per persona or JTBD; each map should cover one narrative
Tasks are too vague ("make it work")Jumped to tasks without defining steps clearlyRevisit steps layer; ensure each step is a concrete user action
MVP line includes everythingTeam can't say no; fear of shipping incompleteApply the "walking skeleton" pattern -- what's the minimum journey that works?
Map doesn't match backlogStory map created once and never referencedPost map in team space; reference it during sprint planning and refinement
Remote workshop produces shallow mapDigital tools don't create the same energy as physical sticky notesUse breakout rooms for parallel step decomposition; time-box strictly
Activities are features, not user goalsFeature-first thinking; activities named after product featuresRewrite activities as user actions: "Configure dashboard" → "Understand my performance"

Success Criteria

  • Story map covers one persona and one narrative end-to-end
  • 3-7 activities spanning the complete user journey
  • Each activity has 3-5 observable steps
  • MVP line drawn with team consensus
  • Release 1 (MVP) is a complete walking skeleton -- every activity has at least one task
  • All tasks are independently deliverable (pass INVEST criteria)
  • Map reviewed and updated at sprint boundaries

Scope & Limitations

In Scope: User story map creation, backbone and body decomposition, release slice definition, MVP scoping, facilitation guidance, workshop planning, template and pattern library.

Out of Scope: Individual story writing and acceptance criteria (see job-stories/ or agile-product-owner), technical architecture decisions, detailed effort estimation, sprint planning mechanics.

Important Caveats: Story maps are planning tools, not contracts. They should be updated as the team learns. A map created before building will always be wrong in details -- the value is in the shared understanding, not the artifact itself. Jeff Patton: "The map is not the territory; the conversation is the territory."

Integration Points

IntegrationDirectionWhat Flows
job-stories/Receives fromJTBD discovery canvas defines the narrative for mapping
create-prd/Feeds intoRelease 1 tasks inform PRD scope (Sections 7 and 8)
prioritization-frameworks/ComplementsRICE scoring prioritizes within release slices
brainstorm-okrs/ComplementsRelease slices align with quarterly OKR targets
outcome-roadmap/Feeds intoRelease slices map to Now/Next/Later roadmap horizons
wwas/Feeds intoTasks become WWAS backlog items with strategic context

References

  • Jeff Patton, *User Story Mapping* (2014)
  • Jeff Patton, "The New User Story Backlog Is a Map" (2005)
  • Inspired by Productside story mapping workshops

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

35.16%
按下载量换算55

Claude

30.34%
按下载量换算48

Cursor

16.42%
按下载量换算26

Gemini CLI

9.46%
按下载量换算15

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills