用途:在编写或审查 DOTween 代码前加载的设计规则模块,规则逐条引用 Demigiant DOTween 1.3.015 源码的文件与行号,便于审计,避免 AI 依赖过时记忆即兴发挥。覆盖触发场景包括编写或审查 DOTween 代码、构建序列动画、绑定补间生命周期、排查补间陷阱。
主要规则要点:DOTween.Init(recycleAllByDefault, useSafeMode, logBehaviour) 返回 IDOTweenInit 可链式 SetCapacity,未显式调用则在首个补间创建时自动初始化;版本常量 DOTween.Version = "1.3.015"。所有补间由单个 [DOTween] GameObject 上的 DOTweenComponent 驱动并 DontDestroyOnLoad,不要销毁它,唯一受支持的清理方式是 DOTween.Clear(destroy: true)。默认 autoKill = true,完成后补间被杀死,此后 Restart/Kill/Complete 为无操作或空引用;需重放用 SetAutoKill(false)。Safe Mode 默认开启,目标被销毁时捕获异常并按 safeModeLogBehaviour 记录(默认 Warning)。SetLink(gameObject, LinkBehaviour) 绑定生命周期,默认 KillOnDestroy。SetTarget 是 DOTween.Kill(target) 分组所必需;快捷扩展会自动设置,手动 DOTween.To 不会。序列 API 含 Append、Join、Insert、Prepend 等。异步等待可用 AsyncWaitForCompletion 等,推荐经 UniTask 的 tween.ToUniTask(TweenCancelBehaviour, CancellationToken)。Ease 枚举共 38 项。
使用方式:先通过 GET /skills/recommend?includeSchema=true 获取参数定义或读取本规则文件,再进入 dryRun;不得凭名称或描述猜测参数。模块按需加载子文档:BASICS、TWEEN、SEQUENCE、SHORTCUTS、EASE、LIFETIME、INTEGRATION、PITFALLS。
适用场景:DOTween 引导与配置、快捷补间、序列组合、生命周期与池容量、Safe Mode 调试、模块生成,以及与其他模块(unitask-design、async、inspector、performance、asmdef、addressables-design)的路由衔接。
限制:仅为文档型建议模块,无 REST 技能需要门控,可在 Approval/Auto/Bypass 任意模式下自由加载。版本范围为 DOTween 1.3.015;早期 1.2.x 多数 API 源码兼容,但 Modules 系统、SetLink、UniTask 桥接 TweenCancelBehaviour 有差异。有疑问时应读所引源码而非凭记忆。官方说明文本暂未提供。