Agent Skills
› Besty0728/Unity-Skills
› unity-primetween-design
unity-primetween-design
GitHub为PrimeTween 1.4.6提供源码级设计规则，涵盖工厂补间、序列管理、回调绑定、异步等待及配置优化。用于编写或审查动画代码，处理生命周期行为，避免常见陷阱如句柄复用错误和内存分配问题。
Trigger Scenarios
编写PrimeTween动画代码
审查PrimeTween动画逻辑
诊断动画生命周期问题
配置PrimeTween参数
Install
npx skills add Besty0728/Unity-Skills --skill unity-primetween-design -g -y
SKILL.md
Frontmatter
{
"name": "unity-primetween-design",
"description": "Source-anchored design rules for PrimeTween 1.4.6 — factory tweens, non-reusable handles, sequences, cycles, callbacks, cancellation, async\/coroutine waiting, and configuration. Use when writing or reviewing PrimeTween animation code or diagnosing its lifecycle behavior. 为 PrimeTween 1.4.6 提供源码锚定的设计规则(工厂补间、不可复用句柄、序列、循环、回调、取消、异步\/协程等待与配置);当用户编写或审查 PrimeTween 动画代码、或诊断其生命周期行为时使用。"
}
PrimeTween - Design Rules
Advisory module. Rules are grounded in the PrimeTween 1.4.6 package installed through com.kyrylokuzyk.primetween.
Mode: Documentation only — no REST skills to gate; load freely under any operating mode.
When to Load This Module
Load before writing or reviewing:
Tween.Position,LocalPosition,EulerAngles,LocalEulerAngles,Scale,Alpha,Color,Custom, delay, or shake calls.Sequence.Create,Chain,Group,Insert, callbacks, or sequence cycles.Tween.Stop,Complete,StopAll,CompleteAll,PausedAll, progress, time scale, or manual update control.OnComplete,OnUpdate, zero-allocation callback overloads, or target-destruction handling.await tween,ToYieldInstruction, serializedTweenSettings,PrimeTweenConfig, or capacity tuning.
Critical Rule Summary
| # | Rule | Source anchor |
|---|---|---|
| 1 | PrimeTween uses static Tween factories. Its Tween handle is a struct, and a completed or stopped handle is dead and non-reusable; create a new tween to replay or reverse an animation. |
Runtime/Tween.cs:53,256-264; readme.md “Controlling tweens” |
| 2 | Use Sequence.Chain for sequential work, Group for parallel work against the previous item, and Insert for absolute-time overlap. This naming differs from DOTween’s Append/Join vocabulary. |
Runtime/Sequence.cs:154,193,202 |
| 3 | A Sequence has its own cycles, cycle mode, easing, update type, and unscaled-time settings at creation. Configure those on Sequence.Create, not through DOTween-style fluent setters. |
Runtime/Sequence.cs:108 |
| 4 | Callbacks can bind a target explicitly with OnComplete<T> or sequence callback overloads. That avoids a capturing closure and lets PrimeTween suppress the callback if its target is destroyed. |
Runtime/Tween.cs:365-382; Runtime/Sequence.cs:228-281 |
| 5 | PrimeTween detects destroyed Unity targets and exposes targeted warnings through PrimeTweenConfig. Do not assume a DOTween SetLink API exists; own a handle and stop it when your component is disabled when that is the intended lifecycle. |
Runtime/Internal/PrimeTweenManager.cs:870-880; Runtime/PrimeTweenConfig.cs:56-87 |
| 6 | await tween and ToYieldInstruction() are supported, but both async state machines and coroutines allocate. For allocation-sensitive animation flows, prefer Sequence. |
Runtime/Internal/AsyncAwaitSupport.cs; Runtime/Internal/CoroutinesSupport.cs; readme.md “Async/await” |
| 7 | TweenSettings and TweenSettings<T> are serializable configuration carriers for Inspector-authored tween values; use them instead of inventing a separate animation settings component. |
Runtime/TweenSettings.cs:25-54; readme.md “Inspector integration” |
| 8 | PrimeTweenConfig is static runtime configuration. It has capacity, default ease/update type, warning controls, and manual-update APIs, but it is not a Resources settings asset. |
Runtime/PrimeTweenConfig.cs:25-101 |
Routing to Other Modules
- Async control flow or cancellation policy → load async and unitask-design.
- Inspector-authored
TweenSettingsfields → load inspector. - Tween-heavy performance analysis → load performance.
- Addressables-loaded targets or scene lifetime → load addressables-design.
Version Scope
This module targets PrimeTween 1.4.6. Its UPM package supports Unity 2018.4+, but Unity Skills itself maintains a Unity 2022.3+ baseline. Check the installed package version before relying on a newer factory overload or PrimeTween Pro feature.
Version History
- 14e175d Current 2026-07-19 18:07
