从需求描述构建状态机图,关键是把自然语言中的生命周期信息拆成五类元素:状态、触发事件、守卫条件、迁移和动作。做法是先锁定一个具有明确生命周期的对象,再按“当前状态—事件[守卫]/动作—目标状态”的句式逐条落表,最后检查初始状态、终止状态、不可达状态和非法迁移。本文给出可直接套用的识别线索、迁移表模板与检查清单。
要点总览(TL;DR)
- 先锁定一个具有明确生命周期的对象,界定起点与终点,同一需求中的多个对象各自建图。
- 按名词/形容词线索抽状态,按动词短语或“当……时”抽事件,按“只有……才”“若……则”抽守卫条件,按“变为”“转为”抽迁移,按“同时”“并”抽动作。
- 把每条需求句转写成“源状态—事件[守卫]/动作—目标状态”的迁移行,记录需求出处,未写明的事件与条件标注待澄清。
- 绘图前做结构检查:初始状态唯一、终止状态存在或说明理由、无不可达状态、无非法迁出且必需迁移齐全。
- 交付前核对元素完整性、表图一致性与需求可追溯性,待澄清项回填后再定稿。
先确定建模对象与状态机边界
状态机图描述的是一个对象在其生命周期内的状态变化。动笔前先回答一个问题:这段需求里,哪个主体对象有“从产生到结束”的完整过程?订单、合同、审批单、设备、账号通常具备这种特征;而“用户”“部门”这类对象在多数需求中只是参与者或归属信息,不适合作为状态机主体。
确定对象后,界定状态机的范围。起点通常是对象被创建或被纳入管理的时刻,终点是对象进入终态(完成、关闭、取消、归档)的时刻。范围之外的过程不画进图里,例如订单发货后的物流轨迹属于另一个对象的状态机,不应混入订单主状态机。
同一段需求常包含多个对象,每个对象各自一张状态机图。判断方法是:如果两个“状态”不能同时成立、且由不同事件驱动,它们多半属于不同对象。建模对象与边界说明可用一段文字加对象清单表达:
- 建模对象:订单
- 生命周期起点:订单提交成功
- 生命周期终点:订单完成、订单取消
- 同需求中的其他对象:支付单(独立状态机)、发货单(独立状态机)
从需求文本识别状态、事件、守卫条件、迁移与动作
五类元素在自然语言中有相对稳定的表达线索。逐句扫描需求,把命中的词句标注出来,再归入对应类别。下表给出识别线索与抽取示例。
| 元素 | 识别线索 | 需求原文示例 | 抽取结果 |
|---|---|---|---|
| 状态 | 表示对象在一段时间内稳定情形的名词或形容词,常与“处于”“状态为”“已”连用 | 订单支付成功后处于“待发货”状态 | 待发货 |
| 触发事件 | 引起状态变化的信号、操作或时间点,常为动词短语或“当……时” | 当仓库完成拣货并出库时 | 出库 |
| 守卫条件 | 迁移发生前必须满足的条件,常为“只有……才”“若……则”“金额超过” | 只有支付金额与订单金额一致才允许发货 | 支付金额=订单金额 |
| 迁移 | 从源状态到目标状态的变化关系,常为“变为”“转为”“进入” | 订单由“待发货”转为“已发货” | 待发货→已发货 |
| 动作 | 迁移过程中或状态内执行的处理,常为“同时”“并”“自动”引出 | 转为“已发货”时同时通知买家 | 通知买家 |
识别时有几个易错点。其一,把动作误当状态:“发送短信”是动作,“已通知”才是状态。其二,把守卫条件误当事件:“金额一致”是条件,触发迁移的事件仍是“发货指令”。其三,遗漏隐含事件:需求写“超时未支付则取消”,事件是“超时”,守卫是“仍未支付”,两者要分开记录。
状态命名保持统一口径,用“已+动词”或业务惯用词,避免同一状态出现“待发货”“未发货”“等待出库”多种写法。事件命名用动词或动词短语,守卫条件写成可判断真假的表达式,动作用动宾结构描述。
按“状态—事件[守卫]/动作—状态”句式逐条落表
识别出的元素需要整理成迁移表,作为绘制状态机图的输入。迁移表至少包含以下字段:迁移编号、源状态、触发事件、守卫条件、动作、目标状态、需求出处。需求出处用于后续追溯,建议记录需求条目编号或原文段落。
逐条转写的步骤:
- 取一句需求原文,判断它描述的是状态、事件、迁移还是动作。
- 若描述迁移,写出源状态和目标状态;源状态缺失时回查上下文补全。
- 找出驱动该迁移的事件,写入事件列。
- 检查句中是否有“只有”“若”等条件词,有则写入守卫条件列。
- 检查是否有“同时”“并”引出的处理,有则写入动作列。
- 记录需求出处,完成一行。
需求中未写明的隐含事件与条件,处理原则是标注待确认,不擅自补成确定事实。例如需求只写“订单可以取消”,未说明哪些状态可取消,应在迁移表中列出候选行并标记“待澄清:可取消的状态范围”。这类标记在评审时集中澄清,比在图中默默假设更可靠。
迁移表模板示例:
| 编号 | 源状态 | 事件 | 守卫条件 | 动作 | 目标状态 | 需求出处 |
|---|---|---|---|---|---|---|
| T1 | (初始) | 提交订单 | — | 生成订单号 | 待支付 | REQ-01 |
| T2 | 待支付 | 支付成功 | 金额一致 | 记录支付时间 | 待发货 | REQ-03 |
| T3 | 待支付 | 超时 | 仍未支付 | 释放库存 | 已取消 | REQ-05 |
检查初始状态、终止状态、不可达状态与非法迁移
迁移表完成后先做结构检查,再绘图。结构缺陷在表阶段比在图上更容易发现。
- 初始状态唯一且可达:每张状态机图应只有一个初始状态,且从初始状态出发能到达所有业务上应出现的状态。存在多个入口时,确认是否混入了其他对象的状态机。
- 终止状态存在且可达:有生命周期的对象通常应有终止状态。若需求确实允许对象长期存在(如长期有效的配置项),可没有终止状态,但要在边界说明中写明理由。
- 不可达状态识别:从初始状态做可达性遍历,凡没有任何入迁移的状态即为不可达。常见原因是迁移表漏行,或该状态属于已废弃的需求版本。
- 非法迁移与缺失迁移:逐状态检查是否存在业务上不允许的出口,例如“已完成”状态不应再有迁出;同时检查业务上必须存在的迁移是否缺失,例如“待发货”是否缺少取消路径。
检查发现的问题分两类处理:结构问题回迁移表修正;语义问题回需求澄清,确认状态含义或业务规则后再改表。每次修正后重新做一遍可达性检查。
角色分工与交付物
状态机建模通常由三类角色协作完成,各自产出明确。
| 角色 | 主要职责 | 交付物 |
|---|---|---|
| 需求分析人员 | 锁定建模对象与边界,逐句抽取五类元素,整理迁移表,执行结构检查 | 对象与边界说明、迁移表、状态机图初稿、待澄清问题清单 |
| 领域专家 | 确认状态语义、业务规则与守卫条件的正确性,判定非法迁移与缺失迁移 | 状态与规则确认意见、澄清结论 |
| 评审者 | 核对约束检查结果,检查迁移表与图的一致性及与需求原文的可追溯性 | 评审记录、问题清单、通过结论 |
分工的关键在于把“抽取”和“确认”分开:分析人员负责把文本转成结构,领域专家负责判断结构是否符合业务。两者混在一起,容易把个人假设当成需求事实。
建模结果需要承载和评审时,可以把状态机图与对应需求条目关联在需求管理工具中。ONES 需求管理支持需求条目的组织、状态流转与评审记录,迁移表和图中的待澄清项可以作为需求条目跟进,评审结论留痕,便于后续追溯。工具承载的是管理动作,状态机本身的建模质量仍取决于上述抽取与检查方法。
示例:从一段需求描述到状态机图
以下为演示用需求原文(示例情景):
订单提交后进入待支付状态。支付成功且支付金额与订单金额一致时,订单转为待发货,同时记录支付时间。待支付状态下超过30分钟未支付,订单自动取消并释放库存。仓库出库后订单转为已发货。买家确认收货后订单完成。待发货状态下买家可申请取消,经审核通过后订单取消。
抽取出的五类元素:
- 状态:待支付、待发货、已发货、已完成、已取消
- 事件:提交订单、支付成功、超时、出库、确认收货、申请取消、审核通过
- 守卫条件:支付金额=订单金额、超过30分钟未支付、审核通过
- 迁移:待支付→待发货、待支付→已取消、待发货→已发货、已发货→已完成、待发货→已取消
- 动作:记录支付时间、释放库存
迁移表:
| 编号 | 源状态 | 事件 | 守卫条件 | 动作 | 目标状态 |
|---|---|---|---|---|---|
| T1 | (初始) | 提交订单 | — | — | 待支付 |
| T2 | 待支付 | 支付成功 | 金额一致 | 记录支付时间 | 待发货 |
| T3 | 待支付 | 超时 | 超过30分钟未支付 | 释放库存 | 已取消 |
| T4 | 待发货 | 出库 | — | — | 已发货 |
| T5 | 已发货 | 确认收货 | — | — | 已完成 |
| T6 | 待发货 | 审核通过 | 买家已申请取消 | — | 已取消 |
检查结论:初始状态唯一,为待支付;终止状态为已完成和已取消,均可从初始状态到达;五个状态全部可达;已完成状态无迁出,符合业务;发现一处待澄清——T6 的“申请取消”是事件还是前置动作,需求原文表述为“可申请取消,经审核通过后取消”,建议将“申请取消”建模为待发货状态内的动作或子状态,评审时与领域专家确认。该问题回填需求澄清清单后,迁移表即可定稿并绘制状态机图。
完成检查:状态机图是否可交付
交付前逐项核对以下清单,全部通过方可进入评审或下游使用。
- 元素完整性:每个状态有名称且命名口径统一;每个迁移有源状态、事件和目标状态;守卫条件写成可判断的表达式;动作有明确执行时机。
- 结构约束:初始状态唯一;终止状态存在或已说明理由;无不可达状态;无业务禁止的迁出;业务必需的迁移均已覆盖。
- 表图一致:迁移表的每一行在图中都有对应箭头,图中每个箭头都能在表中找到对应行;状态集合两边一致。
- 可追溯:每条迁移标注了需求出处;待澄清项已列入问题清单并有责任人;澄清结论已回填迁移表。
- 评审就绪:领域专家已确认状态语义与业务规则;评审者已核对约束检查结果;版本与需求基线对应。
清单中任何一项未通过,回到对应环节修正:元素缺失回 S2 重新抽取,结构问题回 S4 检查,追溯缺失回迁移表补出处。状态机图作为需求表示的一部分,其价值在于让状态、事件和规则在评审中可被逐条讨论,而不是停留在自然语言的模糊描述里。
常见问题
需求里只写了“订单可以取消”,没说明哪些状态可取消,迁移表该怎么处理?
把这条需求拆成候选迁移行,在源状态列列出业务上可能允许取消的状态,并在备注中标记“待澄清:可取消的状态范围”。事件写“取消”,守卫条件留空或写“待确认”。评审时请领域专家逐状态确认,确认后回填守卫条件与源状态,再补入正式迁移表。这样处理能保留需求原文的模糊性,避免在图中默默假设。
守卫条件和触发事件容易混淆,有没有简单的区分办法?
看它回答的是“什么时候发生”还是“发生前要满足什么”。事件是引起状态变化的信号或操作,如“支付成功”“出库”“超时”;守卫条件是迁移发生前必须为真的判断,如“金额一致”“仍未支付”。同一句需求里两者常同时出现:“超时未支付则取消”中,事件是“超时”,守卫是“仍未支付”。迁移表把两者分列,评审时逐行核对即可。
对象确实允许长期存在,没有终止状态,状态机图还能交付吗?
可以。有生命周期的对象通常应有终止状态,但长期有效的配置项、常驻账号等对象可能没有终态。此时在边界说明中写明理由,并在完成检查清单的“终止状态”一项记录例外结论。评审者核对这条理由是否成立,确认后即可进入下游使用。
迁移表改过几轮后,怎么保证图和表还对得上?
每次修改迁移表后重新做一遍比对:表中每一行在图上找对应箭头,图上每个箭头回表中找对应行,状态集合两边逐一核对。建议把比对放在结构检查之后、评审之前,作为固定动作。若图由工具生成,仍要人工核对一次,确认没有因布局或合并产生的多余连线。
状态机图建模结果放在哪里承载和评审比较合适?
建模结果需要与需求条目一起管理和评审时,可以把状态机图、迁移表和待澄清项关联到对应需求条目。ONES 需求管理支持需求条目的组织、状态流转与评审记录,待澄清项可作为需求条目跟进,评审结论留痕,便于后续追溯。工具承载的是管理动作,状态机本身的建模质量仍取决于抽取与检查方法。


















