mcpField
U
user-story-writing

user-story-writing

github.com/aj-geddes开发373789 次安装34 周前更新
代码仓库

关于 user-story-writing

用于撰写以用户为中心的故事,传达需求并定义可测试的验收标准。模板和指南涵盖故事细化、拆分与估算,面向产品及开发团队。

主要功能

  1. 01用户故事模板
  2. 02验收标准指南
  3. 03故事细化流程
  4. 04故事拆分与估算

适用场景

  1. 01将需求拆解为开发工作
  2. 02创建和细化产品待办列表
  3. 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.md
story-estimation.md
story-refinement-process.md
story-splitting.md
scripts/
scaffold-tests.sh
templates/
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