SuperAPI AI 工具集

xstate-v5

通用与其它

查看项目

更新于 10-15 19:48

技能介绍

用途:该技能专注 XState v5 的状态机与状态图工程,仅支持 v5。遇到 v4 风格示例或本地代码时,应翻译为 v5 而非混用版本,优先参考本地仓库代码与官方 v5 文档。

主要能力:在 xstate 与 @xstate/store 之间选型;从模糊需求设计机器或 actor 系统;编写一致的现代 v5 TypeScript 代码;审查、修复和改进现有 XState 代码;迁移遗留 v4 模式;选择合适的 actor 类型与 action 形态;按需接入 @xstate/react、@xstate/vue、@xstate/svelte、@xstate/solid。

使用方式:先检查 package.json 与导入,阅读附近的机器、store、actor 和适配器用法,区分新代码、局部编辑与迁移。新代码优先 setup({...}).createMachine({...}),在 setup 中定义具名 actions、guards、actors、delays,偏好 transition 对象、数组形式 actions、tags 与领域化事件名。简单事件状态管理优先 @xstate/store;存在有限模式、异步流程、子 actor、守卫或延迟时用 XState。UI 侧用 snapshot.matches(...)、tags、snapshot.can(...) 驱动,避免重复布尔量。持久化用 actor.getPersistedSnapshot() 保存,用 createActor(machine, { snapshot }) 恢复。

适用场景:状态机设计、代码审查与修复、v4 到 v5 迁移、actor 系统建模、前端框架集成。

限制:仅覆盖 v5;不主动引入测试指导,除非用户要求;迁移时优先最小安全翻译,不强制统一风格;Stately Studio 与检查工具为可选。具体安装命令与价格资料暂未提供。