SuperAPI AI 工具集

xstate-v5

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:在涉及 XState v5 状态机与 actor(xstate、@xstate/react)的任务中,提供严格的强类型规则集,用于实现、重构和审查状态机,也覆盖从 v4 模式迁移以及状态图设计。

主要能力与强制要求:所有机器使用 setup({...}).createMachine({...});actions、guards、actors 均在 setup 对象内实现;优先通过类型化 params 传递事件派生数据;只发送事件对象,如 actor.send({ type: '...' }),禁止字符串事件;禁止 v4 旧模式(interpret、Machine、cond、send、pure、choose 等)。异步边界需显式:请求/响应用 invoke 配 onDone 与 onError,长期协作用 spawnChild/stopChild 并经 sendTo 路由。禁止“上帝机器”,不相关领域(认证、通知、导航等)不得塞进同一机器,除非是薄编排根;禁止用 context 布尔值镜像 state.value 已表达的状态。

使用方式:先阅读 references/xstate-v5-rules.md,若与技能内容冲突以规则文件为准;文件缺失或不可读时应停止并报告,不得猜测。默认先做状态图设计(状态清单、事件目录、转移表、异步/actor 边界、验收测试场景),再设计类型(types.context、types.events、types.input),最后实现。React 集成推荐模块级 createActorContext,选择器保持稳定,对象选择器用 shallowEqual。测试推荐 waitFor 与 xstate/graph 工具。

适用场景:XState v5 机器/actor 开发、v4 迁移、状态图规划、actor 边界设计、React 共享状态集成、PR 审查。

限制:资料未提供安装命令、版本号、收费或平台信息;具体 API 细节以规则文件与官方文档为准。