SuperAPI AI 工具集

01-user-story-generation

编程与开发

查看项目

更新于 10-16 06:37

技能介绍

用途

本技能用于将高层功能描述转化为结构良好的用户故事,使其符合 INVEST 标准(Independent 独立、Negotiable 可协商、Valuable 有价值、Estimable 可估算、Small 小、Testable 可测试)以及 IEEE Std 29148-2018 需求工程原则。它是瀑布式 SRS 流程在敏捷中的对应物,产出轻量、以用户为中心的需求,适用于 Scrum、Kanban 和 XP 方法。

何时使用

适用场景包括:需要用户故事待办列表的敏捷/Scrum 项目;需求不断演进的 MVP 开发;需要持续利益相关者协作的项目;采用基于冲刺开发的团队;需要快速迭代的初创公司。

不适用场景包括:需要 IEEE 830 SRS 的受监管行业(应改用 ../waterfall/);固定范围、固定价格的合同;需要完整前期需求的项目。

输入文件

技能从 projects/<ProjectName>/_context/ 读取:vision.md(产品愿景与目标,必需)、features.md(高层功能目录,必需)、personas.md(用户画像与角色,推荐)、glossary.md(领域术语,IEEE 610.12,推荐)、quality_standards.md(用于故事验收标准的 NFR 目标,可选)。若 personas.md 不存在,技能会提示创建或从 vision.md 推断。

输出文件

技能写入 projects/<ProjectName>/<phase>/<document>/:user_stories.md(完整用户故事待办列表,Markdown)、story_map.mmd(可视化故事地图,Mermaid)、backlog_summary.md(指标与优先级概览,Markdown)、epic_breakdown.md(史诗→故事层级,Markdown)。

工作流程

  1. 读取 vision.md、features.md,读取或创建 personas.md。
  2. 从功能中提取史诗(Epic)。
  3. 将史诗分解为用户故事。
  4. 应用 INVEST 标准校验。
  5. 生成验收标准。
  6. 估算故事点。
  7. 排定故事优先级。
  8. 编写 user_stories.md、生成 story_map.mmd、创建 backlog_summary.md。

核心步骤

步骤 1:用户画像识别。 读取 personas.md;若缺失则提示用户创建、从 vision.md 推断或跳过(使用通用“User”角色)。创建时识别 3-5 个主要用户类型,定义角色、目标、痛点、技术熟练度。

步骤 2:史诗提取。 解析 features.md,判断每个功能是史诗(>13 故事点,需拆分)、故事(2-13 点)还是任务(<2 点,标记合并)。在 epic_breakdown.md 中创建史诗层级。

步骤 3:故事分解。 按格式生成用户故事:标题、As a [角色] / I want to [动作] / So that [业务价值]、验收标准、故事点(斐波那契 1,2,3,5,8,13)、优先级、所属史诗、依赖、标签。

步骤 4:INVEST 校验。 逐项检查独立、可协商、有价值、可估算、小、可测试,不合规故事标记 [INVEST-FAIL: {criterion}] 并附整改说明。

步骤 5:验收标准生成。 每个故事创建 3-5 条 Given-When-Then(Gherkin)格式标准;若 quality_standards.md 定义了性能/安全目标则追加 NFR 标准。

步骤 6:故事点估算。 使用斐波那契序列,考虑开发、测试、评审时间及前后端、数据库变更、技术债、未知项与依赖。超过 13 点标记 [EPIC: Split Required]。

步骤 7:优先级排序。 依据业务价值、用户影响、依赖关系、风险,分为 Critical、High、Medium、Low。

步骤 8:故事地图。 使用 Jeff Patton 故事地图方法生成 story_map.mmd。

最后步骤: 生成 manifest.md,列出各节文件组装顺序,确保 build-doc.sh 按预期顺序组装。

常见陷阱

在故事中写实现细节;验收标准含糊;故事过大(>13 点);缺少“So that”子句;使用通用用户画像。

验证清单

所有故事遵循 As a / I want / So that 格式;每个故事有 3-5 条可测试验收标准;所有故事 <13 点或标记拆分;INVEST 校验通过;基于业务价值与依赖分配优先级;生成故事地图;待办摘要含冲刺建议;无孤立故事。

与其他阶段的集成

上游依赖 01-strategic-vision/01-prd-generation 提供产品目标,使用愿景阶段的 personas.md。下游消费者:用户故事输入 07-agile-artifacts/01-sprint-planning;验收标准成为 05-testing-documentation/ 的测试用例;史诗影响 03-design-documentation/01-high-level-design。

标准合规

实现 IEEE Std 29148-2018(6.4.2 利益相关者需求获取、6.4.5 需求规格说明)、Agile Alliance 用户故事标准、INVEST 标准(Bill Wake, 2003)、故事地图(Jeff Patton, 2014)、IEEE Std 610.12-1990(术语表对齐)。

维护与更新

当 features.md 新增功能、personas.md 变更、vision.md 更新时重新运行。技能可安全重跑:保留现有故事 ID(US-XXX)、为新功能追加故事、功能变更时更新验收标准、重新生成故事地图与待办摘要。

能力与权限边界

需要读取与搜索权限。仅当请求授权创建或修复指定需求制品时才允许编辑。发布、生产变更、破坏性操作、支出和认证需要明确授权。

降级模式

若必需文件、评审者、标准来源、网络检查、渲染器或执行能力不可用,返回最窄的有用合格结果并标记受影响检查为“未评估”;绝不将未评估检查转为通过。

决策规则

故事超过一个冲刺或合并独立成果时,按用户成果拆分并保留到父史诗的追溯链接。必需输入与测试预言完整时,继续现有工作流并记录证据。缺少强制来源或负责人时,停止受影响分支并发出合格缺口记录。

质量标准

保留稳定标识符及从项目证据到用户故事待办列表、故事地图及其验收检查的双向可追溯性。仅在具备命名指标、方法、阈值、证据来源和负责评审者时应用 ISO/IEEE 度量;发布前运行反劣质门禁。

反模式

从假设上下文生成待办列表(应引用项目来源或标记范围受阻);接受无确定性预言的重要需求(应添加可测量结果、边界和验证方法);未经路由进入验收标准(应移交命名输入并保留追溯链接);将不可用检查视为通过(应标记未评估并说明发布后果);无证据声称标准、法定或利益相关者批准(应引用来源和评审者或限定声明)。

参考

技能编写与发布标准、INVEST 标准、输出示例。故事拆分模式:当故事未通过 Small 或 Independent 测试,或待办列表无影响层级时加载。

版本

最后更新:2026-02-07;技能版本:1.0.0;维护者:Peter Bamuhigire。