⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills

领域建模#

核心原则#

不只是画流程图，而是画出状态机、数据流向、一致性约束点。

加载时机#

什么时候读读哪个选定视图后，取对应画法与要素references/modeling-views.md

三种建模视图 的完整内容已下沉至 references/modeling-views.md，避免每次触发都占用上下文。

建模输出格式#

状态转换表#

当前状态触发事件目标状态守卫条件执行动作待支付用户支付已支付金额正确扣减库存待支付超时已取消超过30分钟释放库存

数据流表#

数据对象源模块目标模块操作一致性检查点订单订单服务订单表创建订单创建后库存库存服务库存表扣减扣减后验证

服务依赖表#

服务依赖服务调用方式故障影响降级策略订单服务库存服务同步下单失败返回库存不足订单服务通知服务异步通知延迟重试+补偿

视图选择速查#

业务特征推荐视图目的产出物有明确状态流转状态转换图跟踪关键对象状态变化状态转换表数据跨模块流转数据流图追踪CRUD和数据一致性数据流表多个服务协同服务依赖图识别故障影响和降级服务依赖表三者均有三种视图全建完整模型三表联动

输出示例#

场景：电商订单状态机建模 → 状态识别：待支付→已支付→已发货→已签收→已完成/已取消/已退款 → 转换分析：正向流转（支付→发货→签收→完成） → 异常转换：支付失败、发货失败、退款申请 → 输出：状态转换表 + 数据流图 + 服务依赖图

场景：用户注册流程 → 数据流建模：注册表单→用户服务→数据库→消息队列→邮件服务

检查清单#

建模完成后检查：

• 是否识别了所有关键状态？
• 状态转换是否完整？
• 数据流是否清晰？
• 服务依赖是否明确？
• 故障影响是否分析？
• 降级方案是否设计？

常见建模误区#

1. 只画图不建表：画了漂亮的状态图但没输出状态转换表 → 图用于理解，表用于测试，缺一不可
2. 状态遗漏：只画了主路径状态，忽略了中间态和异常态 → 逐一检查每个对象的"非法状态"分支
3. 依赖单向：只画了A→B的调用，没画B→A的回调 → 同步调用必须标注返回路径
4. 数据流断链：数据流出后没画终点 → 每条数据流必须标注终点（存储/消费/丢弃）
5. 忽略降级：只标注了故障影响，没标注降级方案 → 所有同步依赖必须附带降级策略