用途：将用户需求转化为可开发的用户故事，既表达“谁受益、想做什么、为什么重要”，也给出可测试的验收标准，作为产品与工程之间的沟通起点，而非最终功能规格。
主要能力：
- 用例采用 Mike Cohn 格式：As a [角色]，I want to [行动]，so that [期望结果]。
- 验收标准采用 Gherkin 格式：Scenario、Given、and Given、When、Then。
- 提供质量检查：角色是否具体、so that 是否说明动机、When 是否对应 I want to、Then 是否对应 so that。
- 提供反模式提示：不写技术任务、不写功能清单、不写含糊不可测的内容。
使用方式：先准备用户画像、问题理解、期望结果与约束；可选用脚本生成 Markdown 模板： python3 scripts/user-story-template.py --persona "trial user" --action "log in with Google" --outcome "access the app without creating a new password" 然后填写模板中的 Summary、Use Case 与 Acceptance Criteria。验收标准可叠加多个 Given，但只应有一个 When 和一个 Then；若出现多个 When/Then，通常提示故事过大，需要拆分。
适用场景：把用户需求整理为开发工作、待办梳理与迭代计划、向工程和设计传达价值、在开发前确保验收标准可测试。
限制：不适用于纯技术债或重构，应改用工程任务；故事过大时应先用 user-story-splitting 拆分；未理解用户问题前应先写问题陈述。缺少上下文时，脚本不会主动取数或写文件。相关技能包括 user-story-splitting、proto-persona、problem-statement、epic-hypothesis。