状态迁移测试 Skill:从状态规则推导有效与异常路径

状态图是设计材料,不是每条迁移都能发生的记录。有效的状态迁移测试要保留规则、守卫、目标状态以及仍需运行时证据的部分。

为什么需要这个 Skill

State Transition Testing Skill 根据已有状态、事件、守卫、动作、角色和持久化证据,推导可达、不可达和异常迁移候选。它不执行测试,也不声称覆盖。

Skill 用来做什么

本文关注的产物是有证据边界的候选路径,不是凭空补出的状态机。

当订单、订阅、审批或事故处理流程存在依赖状态的行为,需要在写用例前得到可追踪候选时,使用这个 Skill。

STT-## 发现包含源状态、事件、前置条件/守卫、动作、目标状态、可达性、证据、影响、负责人、关闭条件和验证方式。

当状态模型发生变化、异常迁移重要,或者团队要在写用例前找出不可达或未验证路径时,使用这个 Skill。

它不做什么

状态迁移测试 Skill 可以组织迁移候选的材料、证据和下一步动作,但它不能替代:

  • 业务或领域负责人对规则、范围和风险的确认。
  • 真实环境、账号、数据、日志或运行结果;静态分析不会自动升级为运行证据。
  • 发布、合规、生产操作和残余风险接受等授权决定。
  • 在输入相互冲突时替团队选择一个未经确认的事实。

它主要检查哪些内容

这个 Skill 的价值不在于把关键词再列一遍,而在于把每个关注点接到可观察的输入、判断和收口动作。先用源 Skill 已定义的输出字段整理一张小矩阵:

检查关注点开始前要问结果应留下什么
迁移候选源状态、事件、守卫、动作和目标STT 编号与来源
可达性可达、不可达、未知或异常候选证据状态
持久化关注迁移后必须保持什么一致数据与副作用
验证动作状态准备和最小安全检查执行前为 NOT_RUN

如果某一行只有经验判断、没有来源或验证方法,就把它留在待确认项里,不要提前写成通过。

开始之前先审计输入

围绕“迁移候选”开始分析时,先把输入分成六种状态。缺口不会自动变成失败,但也不能被隐藏在结论里。

状态含义本 Skill 的处理方式
known材料直接证明的事实标出来源、版本和时间,允许进入判断
missing本轮需要但尚未提供的材料列出最小补证动作,结论保持受限
conflicting来源之间互相矛盾并列来源和冲突点,交给负责人裁决
stale材料存在但版本或时间已经过期标出新鲜度,不把旧结论当当前事实
out_of_scope有关但不在本轮范围内明确排除,避免分析悄悄扩大
assumptions为继续分析而暂时采用的假设写出验证方式和失效条件

至少把输入版本、范围、环境、证据位置和负责人放在一起。没有运行记录时,只能交付分析、设计或验证计划,不能写执行通过。

从问题到结构化发现

先把来源、范围、证据状态、分析判断、责任角色、动作、关闭条件和验证方式连起来,再写结论。下面的案例保留这个 Skill 的专属编号和领域语境。

分层写法

围绕迁移候选,不要把四种语气揉成一句“建议通过”:

层次写法本文应用
事实材料直接显示了什么引用来源中的重点、版本、输入或运行记录
基于证据的推断多个事实共同支持的判断说明推断链,并保留不确定性
建议下一步最小动作是什么指定补证、复核、执行或回归路径
人工决策谁需要决定什么由负责人确认范围、风险接受、资源和发布含义

一个完整案例

本节按输入、分析、发现、决策和验证展开;材料不足时保留 missing、conflicting 或 assumptions,不把它们改写成通过。

输入

材料这次提供什么缺失时的处理
状态来源状态模型、工作流、API 契约或领域决策不要补写缺失状态
事件与守卫触发器、前置条件、角色、权限和时间未知守卫保持未评估
动作与持久化副作用、持久状态、重试和错误迁移设计与观察行为分开
验证上下文环境、数据、状态准备和运行证据未执行候选标记 NOT_RUN

可以这样调用:

请使用 state-transition-testing Skill。

任务:为订单从待支付迁移到已支付、失败、取消或退款推导测试候选。
输入材料:[状态模型、支付事件、角色规则、重试行为和持久化说明]
范围:[结账 staging、银行卡支付流程]
限制:[不要发明状态,也不要声称所有路径已执行]

输出 STT-## 发现,包含状态、事件、守卫、动作、目标、可达性、来源证据、影响、负责人、关闭条件和验证方式。

分析

先根据输入、检查矩阵和证据状态整理判断,再进入发现;缺失材料保留为缺口。

发现

聚焦例子:推导支付失败和退款路径,不要自创规则

模型说明待支付可以到已支付或失败,却没有说明供应商已授权后发生超时怎么办。这个 Skill 应保留缺失守卫,追问目标状态是失败、待复核还是其他已批准状态;不能因为支付系统通常有超时,就自行添加状态。

结果是可追踪的测试设计清单,不能证明可达性、执行、覆盖或发布就绪。

示例发现:把一次问题写成可交接动作

下面的字段示例只展示记录方式,不代表真实环境已经执行。

假设当前材料无法证明“迁移候选”已经满足要求,发现可以这样写。它既不替团队补写规则,也不把缺失证据伪装成失败。

字段示例写法
来源与范围记录本轮使用的需求、版本、环境和迁移候选的具体对象
发现迁移候选的判断条件或结果仍缺少可追溯依据
证据状态missing / assumptions;如果来源相互矛盾则改为 conflicting
影响与优先级说明会影响哪个用户、链路或交付决定,不凭感觉扩大等级
负责人和人工决策由业务、开发、安全或测试负责人确认规则和风险取舍
动作与关闭条件补齐最小证据;关闭条件是来源、判断和责任人都能复核
验证指定一次可重复的检查、查询或运行,并保存原始产物

这类记录的重点是让下一位同事能从发现回到来源,再执行一项能改变结论的动作。

决策

责任角色和待决策问题应由对应负责人确认;Skill 不替他们做风险取舍。

验证

关闭前按发现中的验证方式执行,并保留原始产物;没有执行记录时,状态仍然保持未验证。

发现如何进入下一阶段

交接产物

产物要回答的问题示例状态
迁移候选源状态、事件、守卫、动作和目标STT 编号与来源
可达性可达、不可达、未知或异常候选证据状态
持久化关注迁移后必须保持什么一致数据与副作用
验证动作状态准备和最小安全检查执行前为 NOT_RUN

每条结论都应该能回到来源、证据状态和下一步动作。材料不足时使用 pending、blocked、未评估或 NOT_SCORED,不要用自信填空。

下一步路由

至少交付来源、证据状态、负责人、关闭条件和验证动作;下一阶段的结论仍受证据状态约束。

怎样准备更好的输入

提供权威状态来源、事件、守卫、角色、动作、持久化规则、版本、环境和已知运行 Trace。未知规则保持未评估或 blocked。

交接时至少保留输入版本、范围、时间窗口、证据索引、假设、人工决策边界和最小验证动作。

和其他 Skill 怎么配合

容易踩的坑

  1. 把静态状态图当成每条箭头都可执行的证明。
  2. 按领域惯例补写缺失状态和守卫。
  3. 把候选数量当成覆盖或通过证据。

安装与调用

npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/state-transition-testing -g
请使用 state-transition-testing Skill。
提供目标、范围、版本、证据路径、限制和决策边界。
先审计输入,保留证据状态,最后给出负责人、关闭条件和验证方式。

常见问题

这个 Skill 会写完整测试用例吗?

它可以推导可追踪候选,但不应扩展成完整策略或执行结果。

这里的 NOT_RUN 是什么意思?

迁移已经被识别,但没有授权运行时证据。它必须与不可达或通过分开。

参考

源 Skill 与执行契约

完整执行规则在 状态迁移测试 提示词。源目录 中还可能包含评测用例和补充材料。

静态计划、文件存在和 dry-run 保留原有证据状态,不能变成运行时证明、全部通过结论或发布批准。

参考链接

分享