技能使用指南

user-story-canvas(用户故事地图生成器)Skill 是什么?如何一键生成需求地图?

用户故事地图生成器Skill 能把产品需求按 Epic→Feature→Story 三层结构,一键生成带 MoSCoW 优先级色标与 Release 版本划线的交互式 HTML 故事地图,单文件可直接浏览器打开、支持 A3 打印。本文详解功能特点、安装思路、分步使用指南、竞品对比与典型应用场景,帮你快速把 backlog 讲清楚,立即上手试试。

用户故事地图生成器Skilluser-story-canvas
8 个章节 约 14 分钟阅读 AI 智能生成

用户故事地图生成器Skill:把一堆需求变成一张能看懂、能排版的交互式故事地图

  • 一句话定位:把产品需求按 Epic → Feature → Story 三层结构,一键生成自包含的交互式 HTML 用户故事地图。
  • 两个关键能力:MoSCoW 优先级色标(Must/Should/Could/Wont)+ Release 版本划线分组,让“这个版本做什么”一眼看清。
  • 零门槛交付:只输出一个 HTML 文件,无外部依赖,双击浏览器就能打开,还能打印成 A3 横版贴墙。
  • 上手方式:你只需要用自然语言描述项目需求,Agent 会引导你梳理层级、确认优先级与版本归属,再调用脚本生成页面。
  • 适合谁用:产品经理、需求分析师、敏捷教练、技术负责人,以及任何需要把 backlog 讲清楚的人。

该技能叫什么?如何一键安装 AI 技能提升开发效率?

技能中文名:用户故事地图生成器Skill 技能英文名:user-story-canvas 技能ID:14348

它解决的是一个非常具体、也非常普遍的痛点:产品需求通常散落在文档、表格、聊天记录和脑子里,层级不清、优先级不明、版本归属混乱。开会时大家都在说“这个功能重要”,但没人能一眼看出“Release 1 到底要做多少张卡片、哪些是 Must”。这个技能做的事,就是把零散需求整理成 Epic(价值主题)→ Feature(功能模块)→ Story(最小可交付用户故事) 三层结构,并用颜色和分割线把优先级与版本直接画出来。

所谓“一键安装”,指的是把 AI 技能挂载到你的 AI 编程/办公助手环境中,之后用一句自然语言就能触发生成流程,而不需要自己写模板、调样式、拼 HTML。具体操作可以按以下思路进行:

  1. 确认安装前提:你的环境需要支持 AI 技能(Skill)的加载,并能执行 Python 脚本(技能通过 Python 脚本生成 HTML)。具体支持的宿主环境与版本要求,以官方说明为准。
  2. 获取并加载技能:通过技能市场或官方提供的安装入口搜索技能名 user-story-canvas 或技能ID 14348 完成添加。安装命令、入口路径等以官方说明为准。
  3. 验证是否生效:加载后直接说一句触发语,例如“帮我画一张故事地图”“把需求按版本排列出来”“做一张 story mapping”,若助手开始反问你项目名称、Epic 列表和版本计划,说明技能已成功触发。技能描述中明确列出了触发关键词:用户故事地图、story mapping、需求地图、epic feature story、backlog 可视化、MoSCoW 优先级、release planning、版本规划地图、产品路线图可视化。
  4. 完成一次最小闭环:用一个小项目(比如 1 个 Epic、2 个 Feature、3 个 Story)跑通全流程,确认能拿到可打开的 HTML 文件,再投入真实项目。

需要强调的是:这个技能不需要你预先准备任何数据结构,也不需要画原型。你描述需求,它负责整理和渲染。

该技能的主要功能和特点

  • 三层结构可视化:Epic 作为大的价值主题,Feature 是其中的功能模块,Story 是最小可交付单元,三层以卡片布局逐级呈现,而不是一堆平铺的列表项。
  • MoSCoW 优先级色标:Must(红色)、Should(橙色)、Could(蓝色)、Wont(灰色)四档,用颜色直接标注在卡片上,谁重要谁不重要不再靠嗓门决定。
  • Release 版本划线分组:用水平分割线把故事卡片按版本归组,Release 1(MVP)线以上即第一个版本必须交付的内容,Release 2 线以上即第二个版本的计划,依次类推。
  • 自包含 HTML 输出:生成的是单文件页面,没有外部依赖,不联网也能打开,方便发给任何人或归档。
  • 交互与统计:鼠标悬停可查看 Story 详情,页面自带统计面板,按优先级与版本汇总 Story 数量和 Points。
  • 响应式与打印友好:支持水平滚动适配大地图,打印时自动适配 A3 横版,适合贴墙做发布规划会。
  • 内置校验:脚本会检查 Story 引用的 Release 名是否存在于 releases 列表中,priority 只接受 must / should / could / wont 四个值,降低数据错误。
  • 中英文兼容:项目名、Epic 名等支持中英文混合,中文团队可直接使用。

和“用表格手搓一份需求清单”相比,它强在结构化与可视化:表格能列出字段,但无法表达层级、颜色语义和版本切割;和“用白板工具手工贴卡片”相比,它强在可复现与可交付:改完数据重跑一次即可,不用重贴一遍。

如何使用该技能?

整个流程由 Agent 引导完成,你只需要提供信息并做确认。标准步骤如下:

步骤 1:用一句话发起请求 例如:“帮我画一个故事地图,我有 3 个 Epic,包含用户注册、商品浏览、下单支付。” Agent 会接着追问项目名称、主要功能模块(Epic)和计划分几个版本发布。

步骤 2:梳理三层结构 逐个 Epic 确认它包含哪些 Feature,每个 Feature 下有哪些 Story。信息项与建议规模如下:

信息项 是否必填 说明
项目名称 必填 显示在地图标题
Epic 列表 必填 建议 2–8 个
每个 Epic 的 Feature 必填 每个 Epic 下 1–6 个
每个 Feature 的 Story 必填 每个 Feature 下 1–10 个
Story 优先级 必填 must / should / could / wont
Story 版本归属 必填 归属哪个 Release
Release 列表 必填 版本名称和描述
Story Points 可选 估算工作量
Story 描述 可选 补充说明

步骤 3:确认优先级与版本归属 Agent 会以表格形式列出每个 Feature 下的故事,并给出建议优先级,你逐条确认或修改;随后确认每个 Story 归属哪个 Release(例如 Release 1 = MVP 核心必备,Release 2 = 体验优化,Release 3 = 增长功能)。

步骤 4:生成 HTML Agent 会把信息组织成 JSON 数据并调用脚本,等价于执行:

python3 scripts/generate_story_map.py --input data.json --output story_map.html

也支持从标准输入读取 JSON 后直接输出文件。命令参数只有两个:--input(可选,不提供则从 stdin 读取)与 --output(必填,输出 HTML 路径)。

JSON 结构大致如下(节选示意):

{
  "project": "电商平台 MVP",
  "releases": [{"name": "Release 1", "description": "MVP 核心功能"}],
  "epics": [{
    "name": "用户系统",
    "features": [{
      "name": "注册登录",
      "stories": [{
        "name": "手机号注册",
        "priority": "must",
        "release": "Release 1",
        "points": 3
      }]
    }]
  }]
}

步骤 5:打开与交付 拿到 story_map.html 后直接用浏览器打开,即可看到三层卡片布局、优先级色标、版本划线与统计面板;需要评审时可直接打印成 A3 横版。

注意事项:若某个 Feature 下没有 Story,该列会显示空白占位;当 Story 总数超过 50 个时,建议拆分为多张子地图,避免单页过于拥挤。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
用户故事地图生成器Skill(user-story-canvas) AI 驱动的故事地图生成器 三层结构、MoSCoW 色标、Release 划线、统计面板、自包含 HTML 需加载 AI 技能并具备 Python 运行环境,用自然语言描述需求即可 版本规划会、MVP 范围界定、需求评审、路线图沟通 优势:一句话生成、单文件可交付、改数据即可重跑;不足:产出为静态页面,非在线协作编辑工具
Jira 等敏捷管理平台 敏捷项目与缺陷管理 Backlog 管理、Sprint、看板、报表 需账号、项目配置与字段建模,成本较高 长期迭代的研发团队日常管理 优势:流程闭环、数据沉淀;不足:故事地图视图通常依赖插件或额外配置,可视化表达层级与版本切割不如专门地图直观
Miro 等在线白板工具 通用协作画布 便签、自由布局、多人实时协作 门槛低,但需手工贴卡片、手工对齐 工作坊、头脑风暴、线下共创 优势:协作体验好、自由度高;不足:纯手工搭建,易乱、难复用,改一次要重贴一遍
电子表格(Excel/在线表格) 通用数据记录 行列字段、筛选排序 几乎零门槛 简单需求清单、临时登记 优势:灵活、人人会用;不足:无法表达 Epic→Feature→Story 的层级与视觉分组,优先级与版本只能靠筛选脑补

选择建议:如果你要的是把需求讲清楚并交付一份可传播的图,用这个技能最省事;如果你要的是团队多人实时共创的长期协作空间,白板或敏捷平台更合适;如果你只是临时记录,表格够用。

该技能的典型应用场景与实际体验情况

场景一:产品经理做 MVP 范围界定 痛点:老板说“先做个 MVP”,但 MVP 到底包含哪些故事、哪些必须砍掉,团队各说各话。 使用方式:用 3 个 Epic、每个 Epic 2–4 个 Feature 描述核心业务,把 Story 分为 Must 和 Should 两档,Release 1 只放 Must。生成地图后,红色卡片数量就是 MVP 的最小集合。 实际体验:上手难度低,难点不在工具而在“愿不愿意下决心定优先级”。效果最直接的是会议上的一次性对齐——指着红色卡片问“这个能不能不做”,比讨论十页文档有效。注意:Story 粒度别太粗,否则一张卡片代表一整周工作量,地图就失去了切割意义。

场景二:敏捷教练主持发布规划会 痛点:版本规划会容易变成争论会,缺少共同的可视对象。 使用方式:会前把候选 Story 全部录入并标好优先级,会上直接投屏地图,停留在 Release 分割线处讨论“线上这些是不是真的都要”。 实际体验:版本划线天然形成讨论锚点。打印成 A3 贴在墙上,用便签追加调整也很顺手。注意:Story 超过 50 个时要拆子地图,否则一页信息过载。

场景三:技术负责人评估工作量与拆解 痛点:需求文档只有文字描述,无法快速看出各版本的工作量分布。 使用方式:给每个 Story 填 points 字段,利用页面统计面板查看各优先级与各版本的 Story 数量与 Points 汇总。 实际体验:Points 是可选字段,填了才有汇总价值。适合在估算会前先看总量级,判断“Release 1 是不是排得太满”。注意:Points 缺失时统计会偏空,需要提前约定好估算口径。

场景四:对外沟通产品路线图 痛点:给客户、合作方或投资人讲路线图时,纯文字或时间轴很难讲清“先做什么后做什么”。 使用方式:把 Release 1/2/3 的描述写清楚,生成 HTML 后直接分享文件或投屏。 实际体验:自包含单文件非常方便传播,不需要对方注册账号。注意:这是规划视图不是承诺书,对外分享前建议先对齐内部口径。

该技能能为用户带来的价值

  • 把“梳理需求”的时间压缩到一次对话:过去用白板手工贴卡片,一个中等规模项目的需求地图往往需要半天到一天;现在用自然语言描述、逐步确认,主要时间花在思考优先级本身,而不是排版。
  • 降低可视化门槛:不需要会画图、不需要设计能力、不需要配置工具,只要能说清楚需求,就能得到一张结构完整、带色标和版本分割的地图。
  • 让优先级决策可追溯:MoSCoW 四档颜色是写进数据的,不是口头共识;版本归属也是数据字段。改了数据重跑一次,地图自动更新,避免“文档一个版本、嘴里一个版本”。
  • 交付物可直接用:单 HTML 文件无依赖、可打印 A3 横版、支持水平滚动,评审会、贴墙、归档、外发都能覆盖。
  • 长期价值在于结构资产:一旦 Story 以层级化方式被记录,后续做迭代规划、范围变更、复盘“当初为什么砍掉这个”时,这张地图就是可复用的历史基线。

常见问题 FAQ

Q1:这个技能怎么安装?需要准备什么? 通过支持 AI 技能的环境加载 user-story-canvas(技能ID 14348),由于技能通过 Python 脚本生成页面,环境需要能执行 Python 脚本。具体的安装入口、命令与版本要求以官方说明为准。装好后用“帮我画一张故事地图”这类触发语即可验证是否生效。

Q2:收费吗?商用可以吗? 技能详情中标注的 license 为 MIT,属于宽松开源许可。是否涉及额外的平台或服务费用,以官方说明为准。

Q3:适合谁用?小团队用得上吗? 产品经理、需求分析师、敏捷教练、技术负责人都适用。小团队其实更需要它——人少意味着没有专职文档角色,一张能一眼看懂的地图,比写十页需求文档更现实。

Q4:Story 太多怎么办?一张地图放得下吗? 技能建议 Epic 控制在 2–8 个、每个 Feature 下 1–10 个 Story。当 Story 总数超过 50 个时,建议拆分成多张子地图,例如按业务域或按版本拆分。页面本身支持水平滚动,但可读性会随规模下降。

Q5:它和 Jira、Miro 这类工具怎么选? 如果目标是“把需求讲清楚并产出一份可传播的图”,选这个技能,成本最低;如果目标是“多人实时共创的长期协作空间”,用 Miro 类白板;如果目标是“迭代执行与流程闭环”,用 Jira 类敏捷平台。三者不冲突,很多团队的做法是:先用本技能生成地图对齐范围,再把确认后的 Story 录入敏捷平台执行。