关于 user-story-writing
用于撰写以用户为中心的故事,传达需求并定义可测试的验收标准。模板和指南涵盖故事细化、拆分与估算,面向产品及开发团队。
主要功能
- 01用户故事模板
- 02验收标准指南
- 03故事细化流程
- 04故事拆分与估算
适用场景
- 01将需求拆解为开发工作
- 02创建和细化产品待办列表
- 03为测试定义验收标准
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ aj-geddes/ useful-ai-prompts --skill user-story-writing安装后在 Claude Code 中输入/user-story-writing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/acceptance-criteria-examples.mdstory-estimation.mdstory-refinement-process.mdstory-splitting.mdscripts/scaffold-tests.shtemplates/test-template.js详细介绍
用户故事编写
目录
概述
编写良好的用户故事能够以用户为中心传达需求,促进讨论,并为开发人员和测试人员提供清晰的验收标准。
适用场景
- 将需求拆分为开发任务
- 创建和梳理产品待办事项列表
- 制定敏捷冲刺计划
- 向开发团队传达功能
- 定义验收标准
- 创建测试用例
快速入门
最小可用示例:
# 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]
Example:
// ... (see reference guides for full implementation)
参考指南
references/ 目录中的详细实现:
| 指南 | 内容 |
|---|---|
| 用户故事梳理流程 | 用户故事梳理流程 |
| 验收标准示例 | 验收标准示例 |
| 用户故事拆分 | 用户故事拆分 |
| 用户故事估算 | 用户故事估算 |
最佳实践
✅ 应该
- 从用户的角度编写
- 关注价值,而非实现方式
- 将用户故事控制在一个冲刺内完成
- 明确验收标准
- 使用一致的格式和术语
- 由产品负责人审核用户故事
- 纳入边缘情况和错误场景
- 链接到需求/业务目标
- 根据经验教训更新用户故事
- 创建可测试的用户故事
❌ 不应该
- 编写以技术任务为中心的用户故事
- 创建过于详细的规格说明
- 编写需要多个冲刺才能完成的用户故事
- 忽略非功能性需求
- 跳过验收标准
- 不必要地创建相互依赖的用户故事
- 编写含糊不清的验收标准
- 忽略边缘情况
- 创建过大的用户故事
- 未经讨论就在冲刺中途更改用户故事
评论
支持 Markdown