AGENT SKILL
01-policy
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
22-ui-tween-system — Policy
Status: ACTIVE AppliesTo: v2 Type: Policy / Entry Point
Purpose
UITweenSystem의 모듈 경계와 구현 규칙을 정의한다.
Hard Rules
- UITween은 UI 전용이다. 지원 대상은
CanvasGroup.alpha,RectTransform.anchoredPosition,LayoutElement.preferredWidth/preferredHeight,Transform.localScale만 허용한다. - UITween은 실행 계층이다. show/hide 타이밍, queue, priority, business rule을 가지면 안 된다.
- 동일 대상의 main transition은 새 실행 시 기존 tween을 cancel 후 교체한다.
- layout / scroll이 소유하는 root
RectTransform에는 tween을 직접 적용하지 않는다.LayoutRoot와VisualRoot를 분리한다. - layout과 공존해야 하는 폭/높이 변화는
LayoutElement.preferredWidth/preferredHeight채널을 사용한다. - panel visibility 전이는
UIBasePanel.Show()/UIBasePanel.Hide()와onShow()/onHide()규약을 따른다. UIBasePanel.Show()/UIBasePanel.Hide()는 선택적 자동 훅이다. frame / panel / container / game event handler의 manualPlay(...)도 1급으로 지원한다.- tween 데이터는 preset 기반으로 정의한다. transition policy를 코드 분기로 하드코딩하지 않는다.
- preset은 channel clip 배열만 사용한다. 단일
Delay / Use* / From* / To*구조는 두지 않는다. - runtime은 compile -> snapshot -> frame result -> apply 흐름으로 고정한다.
- preset authoring은
UITransitionPresetAsset으로 하고, inspector 선택은UI_TRANSITION_PRESET_ID경로를 우선한다. Append/Join만 지원한다. loop, nested DSL, 복잡한 builder는 범위에서 제외한다.- 범용 property tween, reflection setter, gameplay object tween은 금지한다.
AnimSequencePlayer와SceneTransManager는 재사용하지 않는다.- 구형 transition 대체 경로는 만들지 않는다.
- pooled UI는
OnDestroy()cleanup에 의존하지 않는다. 정상 hide / close / despawn 경로에서 명시적으로 cancel한다. UIScrollContainervirtualized row/item의 hide tween은 현재 범위에서 지원하지 않는다.- 이 영역 문서에도
Usage섹션은 만들지 않는다.
Runtime Boundary
권장 runtime 경로:
framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Tween/
권장 구성:
UITweenRunnerUITweenHandleUITweenSequenceUITweenEaseUITransitionPresetUITransitionRuntimeDataUITransitionPlayer