Token导航 LogoToken导航

Agent Skill · 研究检索

user-story-mapping-workshop(用户故事映射研讨会)

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

user-story-mapping-workshop 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为需要联网;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 7,502。

总安装 18,816周安装 784GitHub Stars 3,927下载 6,272核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

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

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

命令行安装

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

skills.shnpx skills
npx skills add https://github.com/deanpeters/product-manager-skills --skill user-story-mapping-workshop

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

交互式研讨会,将平面待办事项转化为按用户工作流程和发布优先级组织的视觉故事地图。

指导产品经理解决五个自适应问题,以定义范围、识别用户、生成骨干活动、确定用户任务的优先级并规划发布片段 生成具有水平叙述流(活动从左到右)和垂直优先级(从上到下必须有到好有)的二维地图 确定行走骨架——所有活动中的最小端对端功能——以及在不破坏核心工作流程的情况下增强的增量发布 输出一个结构化的故事地图,其中包含主干、完整的任务层次结构和三个发布切片,可供利益相关者验证和详细的故事编写

来源仓库内路径:skills/user-story-mapping-workshop

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/deanpeters/product-manager-skills --skill user…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要需要联网,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

user-story-mapping-workshop 怎么安装?

在终端执行 npx skills add https://github.com/deanpeters/product-manager-skills --skill user-story-map…。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

user-story-mapping-workshop 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

user-story-mapping-workshop 需要什么权限?

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

user-story-mapping-workshop 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

user-story-mapping-workshop 用的人多吗?

公开数据是累计安装 18,816 次,近一周安装 784 次,下载 6,272 次,GitHub 3,927 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

user-story-mapping-workshop 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 来源仓库有 3,927 星,维护活跃度相对可查。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
user-story-mapping-workshop

用户故事映射研讨会 · 本页

18,8163,927需要联网未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Purpose

Guide product managers through creating a user story map by asking adaptive questions about the system, users, workflow, and priorities—then generating a two-dimensional map with backbone (activities), user tasks, and release slices. Use this to move from flat backlogs to visual story maps that communicate the big picture, identify missing functionality, and enable meaningful release planning—avoiding "context-free mulch" where stories lose connection to the overall system narrative.

This is not a backlog generator—it's a visual communication framework that organizes work by user workflow (horizontal) and priority (vertical).

Key Concepts

What is a User Story Map?

A story map (Jeff Patton) organizes user stories in two dimensions:

Horizontal axis (left to right): Activities arranged in narrative/workflow order—the sequence you'd use explaining the system to someone

Vertical axis (top to bottom): Priority within each activity, with the most essential tasks at the top

Structure:

Backbone (Activities across top)
↓
User Tasks (descending vertically by priority)
↓
Details/Acceptance Criteria (at the bottom)

Key Principles

The Backbone: Essential activities form the system's structural core—these aren't prioritized against each other; they're the narrative flow.

Walking Skeleton: The highest-priority tasks across all activities form the minimal viable product—the smallest end-to-end functionality.

Ribs: Supporting tasks descend vertically under each activity, indicating priority through placement.

Left-to-Right, Top-to-Bottom Build Strategy: Build incrementally across all major features rather than completing one feature fully before starting another.

Why This Works

  • Visual communication: Story maps remain displayed as information radiators, maintaining focus on the big picture
  • Narrative structure: Organizes by user workflow, not technical architecture
  • Release planning: Horizontal slices reveal MVPs and incremental releases
  • Gap identification: Reveals missing functionality that flat backlogs obscure

Anti-Patterns (What This Is NOT)

  • Not a Gantt chart: Story maps show priority, not time estimates
  • Not technical architecture: Maps follow user workflow, not system layers (UI → API → DB)
  • Not a project plan: It's a discovery and communication tool, not a schedule

When to Use This

  • Starting a new product or major feature
  • Reframing an existing backlog (moving from flat list to visual map)
  • Aligning stakeholders on scope and priorities
  • Planning MVP or incremental releases

When NOT to Use This

  • Single-feature projects (story map overkill)
  • When backlog is already well-understood and prioritized
  • For technical refactoring work (no user workflow to map)

Facilitation Source of Truth

Use workshop-facilitation as the default interaction protocol for this skill.

It defines:

  • session heads-up + entry mode (Guided, Context dump, Best guess)
  • one-question turns with plain-language prompts
  • progress labels (for example, Context Qx/8 and Scoring Qx/5)
  • interruption handling and pause/resume behavior
  • numbered recommendations at decision points
  • quick-select numbered response options for regular questions (include Other (specify) when useful)

This file defines the domain-specific assessment content. If there is a conflict, follow this file's domain logic.

Application

This interactive skill asks up to 5 adaptive questions, offering 3-4 enumerated options at each step.

Use template.md for the facilitation agenda and outputs checklist.

Interaction pattern: Pair with skills/workshop-facilitation/SKILL.md when you want a one-step-at-a-time flow with numbered recommendations at decision points and quick-select options for regular questions. If the user asks for a single-shot output, skip the multi-turn facilitation.


Step 0: Gather Context (Before Questions)

Agent suggests:

Before we create your story map, let's gather context:

Product/Feature Context:

  • What system or feature are you mapping?
  • Product concept, PRD draft, or existing backlog
  • Website copy, positioning materials, or user flows
  • Existing user stories (if transitioning from flat backlog)

User Context:

  • Target personas or user segments
  • User research, interviews, or journey maps
  • Jobs-to-be-done or problem statements

You can paste this content directly, or describe the system briefly.


Question 1: Define Scope

Agent asks: "What are you mapping? (What's the scope?)"

Offer 4 enumerated options:

  1. Entire product — "Full end-to-end system from discovery to completion" (Common for new products or full rewrites)
  2. Major feature area — "Specific workflow within a larger product (e.g., 'onboarding,' 'checkout,' 'reporting')" (Common for feature launches)
  3. User journey — "Specific user goal or job-to-be-done (e.g., 'hire a contractor,' 'file taxes')" (Common for JTBD-driven mapping)
  4. Redesign/refactor — "Existing product/feature being rebuilt or simplified" (Common for legacy system modernization)

Or describe your specific scope.

User response: [Selection or custom]


Question 2: Identify Users/Personas

Agent asks: "Who are the primary users for this map? (List personas or user segments.)"

Offer 4 enumerated options:

  1. Single persona — "One primary user type (e.g., 'small business owner')" (Simplifies mapping, good for MVP)
  2. Multiple personas, shared workflow — "Different user types, same core activities (e.g., 'buyer' and 'seller' both browse listings)" (Common for marketplaces)
  3. Multiple personas, different workflows — "Different user types with distinct workflows (e.g., 'admin' vs. 'end user')" (Requires separate maps or swim lanes)
  4. Roles within organization — "Different job functions (e.g., 'PM,' 'designer,' 'engineer')" (Common for internal tools)

Or describe your users.

Adaptation: Use personas from context provided in Step 0 (proto-personas, JTBD, etc.)

User response: [Selection or custom]


Question 3: Generate Backbone (Activities)

Agent says: "Let's build the backbone—the narrative flow of activities users perform to accomplish their goal."

Agent generates 5-8 activities based on scope (Q1) and users (Q2), arranged left-to-right in workflow order.

Example (if Scope = "E-commerce checkout"):

Backbone Activities (left to right):

1. Browse Products
2. Add to Cart
3. Review Cart
4. Enter Shipping Info
5. Enter Payment Info
6. Confirm Order
7. Receive Confirmation

Agent asks: "Does this backbone capture the full workflow? Should we add, remove, or reorder activities?"

User response: [Approve, modify, or add custom activities]


Question 4: Generate User Tasks (Under Each Activity)

Agent says: "Now let's add user tasks under each activity, organized by priority (top = must-have, bottom = nice-to-have)."

Agent generates 3-5 user tasks per activity, arranged vertically by priority.

Example (for Activity 2: "Add to Cart"):

Add to Cart (Activity)
├─ Add single item to cart (must-have, walking skeleton)
├─ Adjust quantity (must-have)
├─ Add multiple items at once (should-have)
├─ Save item for later (nice-to-have)
└─ Add gift wrapping (nice-to-have)

Agent repeats for all backbone activities, showing the full map.

Agent asks: "Does this capture the key tasks? Are priorities correct (top = MVP, bottom = later releases)?"

User response: [Approve, modify, or add custom tasks]


Question 5: Identify Release Slices (Walking Skeleton + Increments)

Agent says: "Let's define release slices by drawing horizontal lines across the map."

Agent generates 3 release slices:

Release 1 (Walking Skeleton): Top-priority tasks across all activities—minimal end-to-end functionality

Release 2 (Next Increment): Second-priority tasks that enhance the core workflow

Release 3 (Polish/Expansion): Third-priority tasks (nice-to-haves, edge cases, optimizations)

Example:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Release 1 (Walking Skeleton):
- Browse products (basic list view)
- Add single item to cart
- Review cart (line items + total)
- Enter shipping info (name, address)
- Enter payment info (credit card only)
- Confirm order (basic confirmation)
- Receive email confirmation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Release 2 (Enhanced):
- Product filtering/search
- Adjust quantity in cart
- Save for later
- Multiple shipping options
- Multiple payment methods
- Order tracking link
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Release 3 (Polish):
- Product recommendations
- Guest checkout
- Gift wrapping
- Promo codes
- Advanced payment options
- Post-purchase surveys
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Agent asks: "Do these release slices make sense? Should we adjust scope or priorities?"

User response: [Approve or modify]


Output: User Story Map

After completing the flow, the agent outputs:

# User Story Map: [Scope from Q1]

**Users:** [From Q2]
**Date:** [Today's date]

---

## Backbone (Activities)

[Activity 1] → [Activity 2] → [Activity 3] → [Activity 4] → [Activity 5] → [Activity 6]

---

## Full Story Map

### [Activity 1: Name]
- **[Task 1.1]** — Must-have (Release 1)
- **[Task 1.2]** — Should-have (Release 2)
- **[Task 1.3]** — Nice-to-have (Release 3)

### [Activity 2: Name]
- **[Task 2.1]** — Must-have (Release 1)
- **[Task 2.2]** — Should-have (Release 2)
- **[Task 2.3]** — Nice-to-have (Release 3)

[...repeat for all activities...]

---

## Release Slices

### Release 1: Walking Skeleton (MVP)
**Goal:** Minimal end-to-end functionality

**Stories:**
- [Task 1.1] — [Activity 1]
- [Task 2.1] — [Activity 2]
- [Task 3.1] — [Activity 3]
- [Task 4.1] — [Activity 4]
- [Task 5.1] — [Activity 5]
- [Task 6.1] — [Activity 6]

**Why this is the walking skeleton:** Delivers complete workflow with simplest version of each activity.

---

### Release 2: Enhanced Functionality
**Goal:** Improve core workflow with priority enhancements

**Stories:**
- [Task 1.2] — [Activity 1]
- [Task 2.2] — [Activity 2]
- [Task 3.2] — [Activity 3]
[...]

---

### Release 3: Polish & Expansion
**Goal:** Nice-to-haves, edge cases, optimizations

**Stories:**
- [Task 1.3] — [Activity 1]
- [Task 2.3] — [Activity 2]
[...]

---

## Next Steps

1. **Refine stories:** Use `skills/user-story/SKILL.md` to write detailed stories with acceptance criteria
2. **Estimate effort:** Score stories (story points, t-shirt sizes)
3. **Validate with stakeholders:** Walk through map left-to-right, confirm priorities
4. **Display map:** Print/post as information radiator for ongoing reference

---

**Ready to write user stories? Let me know if you'd like to refine the map or break down specific stories.**

Examples

Example 1: Good Story Map (E-commerce Checkout)

Q1 Response: "Major feature area — E-commerce checkout workflow"

Q2 Response: "Single persona — Online shopper"

Q3 - Backbone Generated:

Browse → Add to Cart → Review Cart → Enter Shipping → Enter Payment → Confirm → Receive Confirmation

Q4 - User Tasks Generated:

Browse Products
├─ View product list (R1)
├─ Search/filter (R2)
└─ Product recommendations (R3)

Add to Cart
├─ Add single item (R1)
├─ Adjust quantity (R2)
└─ Save for later (R3)

Review Cart
├─ View line items + total (R1)
├─ Apply promo code (R2)
└─ Estimate shipping cost (R3)

[...etc...]

Q5 - Release Slices:

  • Release 1: Walking skeleton—basic flow with no extras
  • Release 2: Search, quantity adjustment, promo codes
  • Release 3: Recommendations, guest checkout, gift options

Why this works:

  • Backbone follows user narrative (not technical layers)
  • Walking skeleton delivers end-to-end value
  • Incremental releases add sophistication without breaking core flow

Example 2: Bad Story Map (Technical Layers)

Backbone (WRONG):

UI Layer → API Layer → Database Layer → Deployment

Why this fails:

  • Not user-centric (users don't care about technical architecture)
  • Can't deliver end-to-end value incrementally
  • Waterfall thinking disguised as story mapping

Fix:

  • Map by user workflow: "Sign Up → Configure Settings → Invite Team → Start Project"
  • Each release delivers full workflow, not a single layer

Common Pitfalls

Pitfall 1: Flat Backlog in Disguise

Symptom: Story map is just a vertical list, no horizontal narrative

Consequence: Loses communication benefit; still "context-free mulch"

Fix: Force horizontal structure—activities across top, tasks descending vertically


Pitfall 2: Technical Architecture as Backbone

Symptom: Backbone = "Frontend → Backend → Database"

Consequence: Not user-centric, can't deliver value incrementally

Fix: Backbone should follow user workflow, not system layers


Pitfall 3: Feature-Complete Waterfall

Symptom: Release 1 = "Build Activity 1 fully," Release 2 = "Build Activity 2 fully"

Consequence: No end-to-end value until all activities complete

Fix: Walking skeleton = thin slice across ALL activities, incrementally enhanced


Pitfall 4: Too Much Detail Too Soon

Symptom: Trying to map every edge case and acceptance criterion upfront

Consequence: Analysis paralysis, lost big picture

Fix: Start with backbone + high-level tasks, refine later


Pitfall 5: Map Hidden in a Tool

Symptom: Story map lives in Jira/Miro, never displayed

Consequence: Loses value as information radiator

Fix: Print/post map physically; make it visible to team daily


References

Related Skills

  • skills/user-story-mapping/SKILL.md — Component skill with story mapping template
  • skills/user-story/SKILL.md — Converts map tasks into detailed user stories
  • skills/proto-persona/SKILL.md — Defines users for mapping
  • skills/jobs-to-be-done/SKILL.md — Informs backbone activities

External Frameworks

  • Jeff Patton, *User Story Mapping* (2014) — Origin of story mapping framework
  • Jeff Patton, "The New User Story Backlog is a Map" (blog) — Explains backbone concept

Dean's Work

  • [If Dean has story mapping resources, link here]

Provenance

  • Derived from skills/user-story/SKILL.md, skills/user-story-splitting/SKILL.md, and skills/user-story-mapping/SKILL.md.

Skill type: Interactive Suggested filename: user-story-mapping-workshop.md Suggested placement: /skills/interactive/ Dependencies: Uses skills/user-story-mapping/SKILL.md, skills/user-story/SKILL.md, skills/proto-persona/SKILL.md

平台分布

Codex

34.83%
按下载量换算2,185

Claude

30.67%
按下载量换算1,924

Cursor

19.49%
按下载量换算1,222

Gemini CLI

8.41%
按下载量换算527

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

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

安装前确认

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

继续浏览同类 Skills