User Story Mapper 是一个用户故事地图 HTML 生成器，用于将产品需求按 Epic → Feature → Story 三层结构可视化到交互式 HTML 页面中，并支持 MoSCoW 优先级色标与 Release 版本划线分组。
用途与结构：地图采用三层结构。Epic 表示大的价值主题或用户活动，例如用户注册与登录；Feature 是 Epic 下的功能模块，例如手机号注册、邮箱注册、第三方登录；Story 是最小可交付的用户故事，例如作为用户，我可以用手机号+验证码注册。每个 Story 需标注 MoSCoW 优先级（must 红、should 橙、could 蓝、wont 灰）和所属 Release。Release 通过水平分割线将故事卡片按版本归组，线以上为对应版本需交付的内容。
使用方式：用户提供产品需求信息后，Agent 会引导梳理 Epic / Feature / Story 层级，确认 MoSCoW 优先级和 Release 归属；随后按指定 JSON 格式构建数据，再调用脚本生成 HTML。生成命令示例：python3 scripts/generate_story_map.py --input data.json --output story_map.html，也可从 stdin 读取 JSON，--output 为必填参数，--input 可选。输出为无外部依赖的自包含 HTML 文件，可直接在浏览器打开。
JSON 数据字段：project（项目名称，必填）、releases（版本列表，必填，含 name 与可选 description）、epics（必填，含 name 与 features）、features（含 name 与 stories）、stories（含 name、priority、release，可选 points 和 description）。priority 仅接受 must / should / could / wont。
生成的 HTML 特性：Epic → Feature → Story 三层卡片布局、MoSCoW 优先级色标、Release 版本划线分组、响应式设计支持水平滚动、打印友好（自动适配 A3 横版）、鼠标悬停显示 Story 详情、统计面板汇总各优先级与版本的 Story 数量和 Points。
限制：脚本会校验 Story 引用的 Release 名是否存在于 releases 列表，并校验优先级取值；某 Feature 下无 Story 时显示空白占位；项目名、Epic 名等支持中英文混合；Story 总数超过 50 个时建议拆分为多张子地图。资料未说明是否需要联网、具体运行环境版本要求或收费信息。