用户故事模板怎么填写:空白表、字段说明与示例
用户故事模板的填写顺序可以按“先角色与价值,再验收条件,最后补优先级与依赖”推进:先用一句话写清谁在什么场景下要完成什么动作、获得什么价值,再把“做完”的标准拆成可观察的验收条件,最后补齐优先级、估算、依赖与状态,让这条故事能进入评审和排期。下面给出一张可直接复制的空白表、逐字段填写规范、必填与选填对照,以及一条完整示例。
Table of Contents
要点总览(TL;DR)
- 用户故事模板由故事主表和验收条件子表组成:主表承载标题、角色、目标动作、业务价值、优先级、估算、依赖、状态等字段,子表逐条记录可观察的验收结果。
- 填写顺序是先写角色与业务价值,再按“作为……我希望……以便……”拼出一句话故事,最后补优先级、估算与依赖,让故事能进入评审和排期。
- 验收条件要写成“在什么条件下执行什么操作、看到什么结果”,每条只描述一个可判断的结果,避免“性能良好”“界面友好”这类主观表述。
- 故事标题、角色、目标动作、业务价值和验收条件是必填项;估算、依赖、负责人等可暂缺,但要用“待定”加说明或“无”标注清楚,不留白。
- 模板需要按业务类型控制字段增减,并用版本号、变更日期、变更内容、变更原因和影响范围记录每次调整,同步更新字段说明与示例。
可复制空白用户故事模板
这张表分为故事主表和验收条件子表两部分。主表承载故事的身份信息与排期信息,子表承载“怎样算做完”的判断依据。复制到文档或表格工具后,把示例行替换为实际内容即可使用;一条故事对应主表一行,验收条件按条追加到子表。
故事主表
| 字段 | 填写内容 |
|---|---|
| 故事编号 | |
| 故事标题 | |
| 角色 | |
| 目标动作 | |
| 业务价值 | |
| 一句话故事 | 作为____,我希望____,以便____。 |
| 优先级 | |
| 估算 | |
| 依赖 | |
| 状态 | |
| 负责人 | |
| 关联需求/来源 | |
| 备注 |
验收条件子表
| 序号 | 验收条件(可观察结果) | 验证方式 | 是否满足 |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 |
复制使用时注意两点:主表中的“一句话故事”由角色、目标动作、业务价值三个字段拼接而成,填写时保持三者措辞一致;验收条件子表的条数按故事复杂度增减,每条只描述一个可判断的结果,便于逐条勾选。
每个字段填什么:字段说明与填写规范
字段说明的作用是让不同人填出的故事保持同一口径。下表逐字段给出含义、填写口径和常见写法,模板、说明与后面的示例使用同一套字段名称。
| 字段 | 含义 | 填写口径 | 常见写法 |
|---|---|---|---|
| 故事编号 | 故事的唯一标识 | 沿用团队现有编号规则,便于引用与追溯 | US-014 |
| 故事标题 | 一句话概括这条故事要交付的能力 | 用动宾结构,避免只写模块名 | 导出订单明细为表格文件 |
| 角色 | 使用该功能的人或系统角色 | 写具体角色,不写“用户”这类泛称;有多个角色时选主要受益者 | 区域销售主管 |
| 目标动作 | 角色想完成的操作 | 写角色主动发起的动作,动词开头,说明操作对象 | 按时间范围导出本区域订单明细 |
| 业务价值 | 完成动作后带来的结果 | 写对角色或业务的可观察收益,避免“提升体验”这类无法判断的表述 | 月度对账不再手工整理,核对时间从半天缩短到十分钟 |
| 一句话故事 | 三要素的合并表达 | 按“作为……我希望……以便……”句式拼接,与三个字段措辞一致 | 作为区域销售主管,我希望按时间范围导出本区域订单明细,以便月度对账不再手工整理 |
| 优先级 | 相对其他故事的排期顺序 | 用团队统一的等级或排序值,并注明判断依据 | 高(本月对账节点前必须可用) |
| 估算 | 实现该故事的相对工作量 | 沿用团队估算单位,写单位名称,不写精确工时承诺 | 5 故事点 |
| 依赖 | 完成该故事需要的前置条件 | 写清依赖对象和当前状态,没有依赖时明确写“无” | 依赖订单查询接口支持时间范围参数,接口已就绪 |
| 状态 | 故事当前所处环节 | 使用团队看板的统一状态名 | 待评审 / 已就绪 / 开发中 / 待验收 / 已完成 |
| 负责人 | 当前推进该故事的人 | 写具体姓名,评审前可留空 | 张明 |
| 关联需求/来源 | 故事的上游来源 | 填写需求单号或来源文档,便于回溯 | 需求 REQ-208 |
| 验收条件 | 判断故事完成的依据 | 每条写一个可观察结果,包含触发条件、操作和预期结果 | 选择近 30 天范围导出时,文件包含该范围内全部订单且字段与列表页一致 |
三要素的写法值得单独说明。角色要写到能区分权限和视角的程度,“区域销售主管”比“用户”更能指导设计;目标动作要落到操作对象上,“导出订单明细”比“查看数据”更明确;业务价值要能被验证,“核对时间从半天缩短到十分钟”可以在上线后回访确认,而“提高效率”无法判断是否达成。
验收条件的写法遵循“可观察”原则:写清在什么条件下执行什么操作、看到什么结果。避免“性能良好”“界面友好”这类主观描述,改为“导出 1 万条记录在 10 秒内完成”这类可测量的表述。优先级、估算、依赖和状态属于排期信息,填写时以团队既有规则为准,保持同一项目内口径一致即可。
必填与选填:哪些字段不能空
模板字段并非全部同等重要。角色、目标动作、业务价值、验收条件缺失时,故事无法被评审,也无法判断是否完成,这几项应作为必填项;其余字段可以在不同阶段补齐,但需要标注清楚,避免模板被填成空壳。
| 类别 | 字段 | 空缺时的处理方式 |
|---|---|---|
| 必填 | 故事标题、角色、目标动作、业务价值、验收条件 | 不允许留空;信息不足时先留在草稿区,不提交评审 |
| 评审前必填 | 优先级、状态 | 进入评审队列前补齐,否则无法排序 |
| 选填 | 估算、依赖、负责人、关联需求/来源、备注、故事编号 | 暂缺时写“待定”并注明补齐时间或责任人,不直接留白 |
字段暂缺时的标注方式建议统一:用“待定”加简短说明,例如“估算:待定,待技术方案确认后补充”;确实不适用时写“无”,例如“依赖:无”。这样在评审时能一眼区分“还没填”和“确认不需要”,减少反复追问。
完整填写示例:一条用户故事从空白到可评审
下面用一条已填写的故事演示各字段如何配合。示例场景为演示用途,字段取值与前面的说明表一一对应。
故事主表(已填写)
| 字段 | 填写内容 |
|---|---|
| 故事编号 | US-014 |
| 故事标题 | 导出订单明细为表格文件 |
| 角色 | 区域销售主管 |
| 目标动作 | 按时间范围导出本区域订单明细 |
| 业务价值 | 月度对账不再手工整理,核对时间从半天缩短到十分钟 |
| 一句话故事 | 作为区域销售主管,我希望按时间范围导出本区域订单明细,以便月度对账不再手工整理 |
| 优先级 | 高(本月对账节点前必须可用) |
| 估算 | 5 故事点 |
| 依赖 | 依赖订单查询接口支持时间范围参数,接口已就绪 |
| 状态 | 待评审 |
| 负责人 | 张明 |
| 关联需求/来源 | 需求 REQ-208 |
验收条件子表(已填写)
| 序号 | 验收条件(可观察结果) | 验证方式 | 是否满足 |
|---|---|---|---|
| 1 | 选择近 30 天范围导出时,文件包含该范围内本区域全部订单,字段与列表页一致 | 抽样比对导出文件与列表页记录数及字段 | |
| 2 | 导出 1 万条记录在 10 秒内完成,期间页面可正常操作 | 用测试数据执行导出并计时 | |
| 3 | 无数据的时间范围导出时,提示“该范围无订单”且不生成空文件 | 选择无数据范围执行导出 |
对照字段说明可以看到:角色写到了具体岗位,目标动作以动词开头并说明操作对象,业务价值给出了可回访确认的时间变化;三条验收条件分别覆盖数据完整性、性能和边界情况,每条都能通过一次操作判断是否满足。这样的故事进入评审时,讨论焦点会落在验收条件是否充分,而不是反复澄清需求本身。
当团队把这类故事沉淀到文档与工作项中时,可以借助 ONES Wiki 的页面模板库一键创建制式化文档模板,让填写格式保持统一;页面组可关联项目,使需求与文档互相对应。故事进入排期后,文档可关联项目任务,验收条件的勾选状态随工作项推进更新,评审记录也能通过页面版本查看与回滚。ONES Assistant 可基于项目、工作项和 Wiki 页面等上下文回答问题,帮助填写人快速找到同类故事的既有写法。
模板的调整与维护方法
模板用久了会出现两类问题:字段越加越多,填写负担超过收益;或者字段改了但说明和示例没跟上,新成员照着旧示例填错。维护的重点是控制字段增减的取舍,并让模板、说明、示例三者同步。
按业务类型调整字段时,遵循“保留判断完成所必需的字段,按场景增加辅助字段”的原则。面向内部工具的故事可以保留基础字段;涉及合规或对外交付的故事,可增加“合规检查项”“上线窗口”等字段。新增字段前先问两个问题:这个字段是否会影响评审结论或验收判断?如果不会,放到备注里即可,不必进入主表。
模板版本与变更记录建议采用简单格式,附在模板文档末尾:
- 版本号:如 v1.2
- 变更日期:如 2025-03-10
- 变更内容:如新增“依赖”字段,删除“界面原型链接”字段
- 变更原因:如多个故事因依赖未识别导致排期冲突
- 影响范围:如所有新提交故事,存量故事不强制回填
字段增减后,同步更新三处内容:字段说明表中对应行的含义与填写口径、必填与选填对照表、以及至少一条完整示例。示例是新人最常参照的材料,示例与说明不一致时,以说明为准并尽快修正示例。团队可将模板文档放入统一的页面模板库,配合页面版本记录保留每次调整的历史,需要时回滚到旧版本对照。
常见问题
故事标题和一句话故事有什么区别,两个都要填吗?
两者用途不同。故事标题用于在列表、看板和排期表里快速识别这条故事,用动宾结构概括交付内容,例如“导出订单明细为表格文件”;一句话故事用于评审时完整表达角色、动作和价值,按“作为……我希望……以便……”句式拼接。
建议两个都填。标题写短,一句话故事写全,并保持两者措辞一致,避免标题写“数据导出”、故事写“按时间范围导出本区域订单明细”这类对不上的情况。
验收条件写几条比较合适,写多了会不会变成测试用例?
条数按故事复杂度增减,常见做法是覆盖三类情况:正常路径的结果、关键边界或异常情况、与性能或数据量相关的可测量要求。示例中的三条分别对应数据完整性、导出耗时和无数据范围的处理。
验收条件与测试用例的边界在于粒度:验收条件回答“怎样算做完”,一条描述一个可判断的结果;测试用例回答“具体怎么测”,会细化到步骤、数据和预期值。验收条件写得过多、过细,评审会变成测试设计会,可以先把判断完成所必需的结果留下,其余放到测试环节展开。
估算和依赖在评审前填不出来,可以先提交评审吗?
可以,但要标注清楚。优先级和状态属于评审前必填项,否则故事无法排序;估算和依赖可以在评审后补齐,填写时用“待定”加简短说明,例如“估算:待定,待技术方案确认后补充”,并注明补齐时间或责任人。
依赖项建议尽早识别。依赖未确认就进入排期,容易在开发中才发现前置条件不具备,导致排期冲突。评审时可以把“依赖是否已就绪”作为一项确认内容。
团队业务差异大,用一张统一模板还是按业务类型分开?
可以先共用一张基础模板,保留判断完成所必需的字段,再按业务类型增加辅助字段。面向内部工具的故事通常基础字段就够用;涉及合规或对外交付的故事,可增加合规检查项、上线窗口等字段。
新增字段前先判断它是否影响评审结论或验收判断,如果不会,放到备注里即可。分开维护多张模板时,要指定每张模板的适用场景和负责人,避免同类故事被填进不同模板、口径不一致。
模板调整后,存量故事需要按新字段回填吗?
通常不需要强制回填。变更记录中写明影响范围即可,例如“所有新提交故事,存量故事不强制回填”。已经进入开发或已完成的故事,回填的收益有限,反而增加填写负担。
需要回填的情形是字段变化影响验收判断,例如新增了必须确认的合规检查项。这时可以只针对尚未验收的故事补充,并在变更记录中说明范围。



