SuperAPI AI 工具集

user-story

写作与研究

查看项目

更新于 10-15 20:34

技能介绍

用途:把用户需求翻译成开发可用的用户故事,结合 Mike Cohn 的“As a / I want to / so that”格式与 Gherkin 的 Given/When/Then 验收标准。它不是功能规格,而是对话起点,说明谁受益、想做什么、为何重要、如何判断成功。

主要能力:生成用户故事用例与验收标准;提供质量检查(角色是否具体、动作是否清晰、so that 是否说明动机、When/Then 是否对齐);识别反模式(技术任务伪装成故事、角色过于笼统、so that 重复动作、多个 When/Then、不可测试的 Then);可选用脚本生成 Markdown 模板:python3 scripts/user-story-template.py --persona "trial user" --action "log in with Google" --outcome "access the app without creating a new password"。

使用方式:先收集上下文(用户画像、问题理解、期望结果、约束),再填写模板中的用例与验收标准,最后加简短摘要并验证。调用时附带的文本或 ARGUMENTS 行视为已提供答案,不重复询问;空手调用会先询问用户是谁、想完成什么。

适用场景:需求转开发工作、待办梳理与冲刺规划、向工程与设计传达价值、开发前确保验收标准可测试。

限制:不适用于纯技术债或重构(应使用工程任务);故事过大时应先拆分;未理解用户问题前应先写问题陈述。相关技能包括 user-story-splitting、proto-persona、problem-statement、epic-hypothesis。外部框架参考 Mike Cohn《User Stories Applied》、Gherkin 与 INVEST 标准。