AGENT SKILL

20-fsm-controller

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

03 SKILL.md 正文

20-fsm-controller

0. 목적

실전적으로 빠르고 안전한 상태 머신(FSM)을 제공한다. 전이는 try 없이 "무조건 성공"을 전제로 하며, onEnter/onExit 로직이 중요하므로 전이를 건너뛰지 않는다.


1. 구성

  • BaseFsmObject<TState, TOwner>
  • BaseFsmController<TState, TFsm, TOwner>

2. 규약 (Hard)

  • namespace는 Devian 고정.
  • 전이는 FIFO 큐로 처리한다.
  • 미등록 state는 error이며 ChangeState 호출 시 즉시 예외(throw).
  • 큐에 enqueue된 전이는 절대 스킵/덮어쓰기/합치기 없이 모두 실행한다.
  • self-transition 허용 여부는 상태의 AllowSelfTransition만으로 결정된다.
  • 런타임에서 self-transition 정책을 바꾸는 기능은 제공하지 않는다.
  • context/owner는 전이마다 new로 만들지 않고, 컨트롤러 Init(owner)로 1회 바인딩 후 재사용한다.
  • 무한 전이 방지를 위해 1 flush당 최대 전이 수 제한이 있으며 초과 시 예외(throw).
  • 프레임워크 FSM에 Cancel() 기능은 제공하지 않는다. "상태 종료/취소/롤백/중단"은 게임/비즈니스 로직에서 별도 상태/전이로 구현한다.

3. API 요약

  • Register(state)
  • Start(initialState, args...)
  • ChangeState(state, args...)
  • Tick / FixedTick / LateTick

04 同仓库更多 Skills