SuperAPI AI 工具集

tools-visual-state-machines

数据与分析

查看项目

更新于 10-16 06:33

技能介绍

用途

该技能旨在以 ASCII 状态机与故事板的形式,清晰解释用户或问题如何在各个状态之间流转,并明确进入与退出规则。它可用于支撑增长循环、发布流程或问题分诊等技能,通过显式定义状态转换来提升流程的可理解性。

主要能力

  • 定义状态图例:使用 [STATE] 方框表示状态,--> 表示转换箭头,..> 表示可选转换。
  • 绘制故事板:例如从 [New] 经“signup complete”转换到 [Activated],再经“retention event”转换到 [Retained],或从 [Activated] 因“fails SLA”转换到 [Churn Risk]。
  • 添加注释:在箭头上标注边标签(如 >=3 sessions、NPS<30),以及动作(如 /{ send email })。
  • 关联指标:为每个转换提供查询引用或分析仪表板链接。
  • 嵌入文档:可包含在 PR、issue 或 .factory/skills/... 中,并引用文件名(如 state-machines/activation.txt)。

使用方式

输入包括:状态列表(如 New、Activated、Retained、Churned)、转换触发条件(事件、指标、计时器)、每个转换的守卫条件与动作。工作流程为:定义图例、起草故事板、添加注释、关联指标、嵌入文档。

适用场景

适用于需要明确状态流转的流程建模,例如用户旅程分析、留存循环设计、发布流程管理、问题分诊等。

限制

验证要求:每个状态至少有一个入口和出口(Start/End 除外);触发条件需明确定义,不允许无标签箭头;图表需与产品/增长相关方评审以确保准确性。