用户故事地图生成器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。具体操作可以按以下思路进行:
- 确认安装前提:你的环境需要支持 AI 技能(Skill)的加载,并能执行 Python 脚本(技能通过 Python 脚本生成 HTML)。具体支持的宿主环境与版本要求,以官方说明为准。
- 获取并加载技能:通过技能市场或官方提供的安装入口搜索技能名
user-story-canvas或技能ID14348完成添加。安装命令、入口路径等以官方说明为准。 - 验证是否生效:加载后直接说一句触发语,例如“帮我画一张故事地图”“把需求按版本排列出来”“做一张 story mapping”,若助手开始反问你项目名称、Epic 列表和版本计划,说明技能已成功触发。技能描述中明确列出了触发关键词:用户故事地图、story mapping、需求地图、epic feature story、backlog 可视化、MoSCoW 优先级、release planning、版本规划地图、产品路线图可视化。
- 完成一次最小闭环:用一个小项目(比如 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 录入敏捷平台执行。