SuperAPI AI 工具集

user-story-writing

写作与研究

查看项目

更新于 10-14 13:53

技能介绍

用途

该技能面向敏捷开发中的需求表达与拆解工作,核心目标是用用户视角撰写用户故事,并以清晰的验收标准指导开发与测试。它适合在将需求拆解为开发任务、创建和细化产品待办列表、敏捷冲刺规划、向开发团队沟通功能、定义验收标准、创建测试用例等环节使用。

主要能力

  • 提供用户故事模板,结构包含标题、用户角色、期望动作、业务价值,以及用户上下文(用户角色、用户目标、使用场景)和验收标准。
  • 验收标准采用 Given/When/Then(给定/当/那么)的表述形式,文档中给出示例说明。
  • 在 references/ 目录中提供参考指南,内容涵盖:故事细化流程、验收标准示例、故事拆分、故事估算。

使用方式

文档给出最小可用示例(Quick Start),即使用如下模板编写故事:

# User Story Template

**Title:** [Feature name]

**As a** [user role/persona]
**I want to** [action/capability]
**So that** [business value/benefit]

---

## User Context

- User Role: [Who is performing this action?]
- User Goals: [What are they trying to accomplish?]
- Use Case: [When do they perform this action?]

---

## Acceptance Criteria

Given [precondition]
When [action]
Then [expected result]

文档提到完整实现示例可参考 references/ 目录中的参考指南。

适用场景

  • 需求拆解为开发任务
  • 产品待办列表创建与细化
  • 敏捷冲刺规划
  • 向开发团队沟通功能
  • 定义验收标准
  • 创建测试用例

最佳实践(DO / DON'T)

建议(DO):

  • 从用户视角编写
  • 关注价值而非实现
  • 故事足够小,能在一个冲刺内完成
  • 定义清晰的验收标准
  • 使用一致的格式和术语
  • 由产品负责人批准故事
  • 包含边界情况和错误场景
  • 关联需求/业务目标
  • 根据学习更新故事
  • 创建可测试的故事

避免(DON'T):

  • 编写以技术任务为中心的故事
  • 创建过于详细的规格说明
  • 编写需要多个冲刺的故事
  • 忘记非功能性需求
  • 跳过验收标准
  • 不必要地创建有依赖关系的故事
  • 编写含糊不清的验收标准
  • 忽视边界情况
  • 创建过大的故事
  • 未经讨论在冲刺中途更改故事

限制

资料未提供该技能的具体安装命令、平台支持范围、是否收费及价格、实际使用效果等信息,暂未提供。