coordinator
starsforks
How to install coordinator?
hobobo/abilitykit/coordinator
$npx -y skills add HOBOBO/AbilityKit --skill coordinatorAbilityKit 会话协调器（com.abilitykit.coordinator）——位于 Host/World（下层）与 View/Network（上层）之间的会话层编排器。覆盖 SessionCoordinator 生命周期状态机、ISessionCoordinatorHost/ILogicWorldDriverBridge 应用端口、三种 SyncAdapter（Lockstep/SnapshotAuthority+StateSync/Hybrid）、IRemoteBattleSyncTransport、IViewEventSink、View
SKILL.md
| 1 | # coordinator skill |
| 2 | |
| 3 | 基于源码核校（2026-07-20）。`com.abilitykit.coordinator` 包根：`Unity/Packages/com.abilitykit.coordinator/`。 |
| 4 | |
| 5 | ## 核心定位 |
| 6 | |
| 7 | Coordinator 是"会话层编排器"，位于 Host/World（下层）与 View/Network（上层）之间。**不实现具体网络协议、不实现具体 World 逻辑、不创建 Unity 视图对象**。 |
| 8 | |
| 9 | 协调 4 类对象： |
| 10 | 1. **逻辑世界**（IWorld/IWorldHost/HostRuntime）—— 通过 `ISessionCoordinatorHost.CreateWorldHost` |
| 11 | 2. **同步策略**（ISyncAdapter）—— 由 `SyncAdapterFactory` 按 `SessionConfig.SyncMode` 创建 |
| 12 | 3. **表现层**（IViewEventSink + Timeline.IViewTimeline）—— 通过 `SessionCoordinator.Notify*` |
| 13 | 4. **扩展点**（ISessionSubFeature + SessionHooks）—— 按 Priority 挂接 |
| 14 | |
| 15 | ## 包结构 |
| 16 | |
| 17 | ``` |
| 18 | com.abilitykit.coordinator/Runtime/ |
| 19 | ├── Core/ ISessionCoordinator/SessionCoordinator/ISessionCoordinatorHost/ExistingWorldSessionCoordinatorHost |
| 20 | │ ILogicWorldDriverBridge/ILogicWorldDriveGate/ISpawnService/IViewEventSink |
| 21 | │ SessionConfig/SessionId/SessionHooks/SessionEnums |
| 22 | ├── Adapters/ ISyncAdapter + LocalSyncAdapter/RemoteSyncAdapter/HybridSyncAdapter + SyncAdapterFactory |
| 23 | ├── SubFeatures/ ISessionSubFeature 接口族 + ISessionHost + 3 个内置 SubFeature |
| 24 | ├── Timeline/ IViewTimeline + ViewTimeline + ScalarSampleBuffer/VectorSampleBuffer |
| 25 | ├── Transport/ IRemoteBattleSyncTransport + NullRemoteBattleSyncTransport + CoordinatorInputSubmitBridge |
| 26 | └── Data/ PlayerInput/EntityState/FrameSnapshotData/PlayerSpawnData/NetworkEndpoint/CoordinatorPayloadCodec |
| 27 | ``` |
| 28 | |
| 29 | 空目录：`PlayMode/`、`Events/`（仅 `.meta` 占位）。无 `Tests/`、无 `Editor/`。 |
| 30 | |
| 31 | ## 最重要的注意（README 与源码偏差） |
| 32 | |
| 33 | 包内 `README.md` 与 `docs/ET-Integration-Guide.md` **已严重过时**。skill 内容全部基于源码，不以 README 为准。主要偏差： |
| 34 | |
| 35 | - README 写的 `IBattleDriverHost` → 实际是 `ILogicWorldDriverBridge`（多了 `AdvanceFrame` / `Start/Stop`，返回 `SnapshotEntityState[]` 不是 `EntityState[]`） |
| 36 | - README 的 `ISessionCoordinatorHost` 4 个方法 → 实际 5 个（多了 `ConfigureWorldCreateOptions`），另有 `ISessionCoordinatorConfigPolicy` |
| 37 | - README 的 `SyncMode` 3 个值 → 实际 4 个（`Lockstep/SnapshotAuthority/StateSync/Hybrid`） |
| 38 | - README 把 `SessionConfig` 写成 sealed class → 实际是 `struct` |
| 39 | - README 的 `PlayerInput` 用 `InputType` 枚举 + 字典 → 实际是 `int OpCode + byte[] Payload`（MemoryPack） |
| 40 | |
| 41 | 详见 [source_vs_readme.md](source_vs_readme.md)。 |
| 42 | |
| 43 | ## Sections |
| 44 | |
| 45 | - [when_to_use.md](when_to_use.md) — 何时启用本 skill |
| 46 | - [lifecycle.md](lifecycle.md) — SessionCoordinator 状态机 + SessionConfig 工厂方法 + SessionRuntimePolicy |
| 47 | - [host_and_driver_ports.md](host_and_driver_ports.md) — ISessionCoordinatorHost + ExistingWorldSessionCoordinatorHost + ILogicWorldDriverBridge + ILogicWorldDriveGate + ISpawnService |
| 48 | - [sync_adapters.md](sync_adapters.md) — 三种 adapter + HybridSyncAdapter 未完成 TODO |
| 49 | - [transport_and_codec.md](transport_and_codec.md) — IRemoteBattleSyncTransport + CoordinatorInputSubmitBridge + CoordinatorPayloadCodec |
| 50 | - [view_and_timeline.md](view_and_timeline.md) — IViewEventSink + ViewTimeline 采样插值 |
| 51 | - [subfeatures_and_hooks.md](subfeatures_and_hooks.md) — ISessionSubFeature 接口族 + 内置 3 个 + SessionHooks 全字段 |
| 52 | - [integration_recipes.md](integration_recipes.md) — moba 与 shooter 两种接入模式（含真实调用链） |
| 53 | - [source_vs_readme.md](source_vs_readme.md) — README 9 处偏差对照 |
| 54 | |
| 55 | ## 相关 skill |
| 56 | |
| 57 | - 完整技能/触发/BUFF 速查见 [ability-kit](../ability-kit/SKILL.md) |
| 58 | - host.extension 的 BattleHost/FrameSync 见 [host-extension](../host-extension/SKILL.md) |
| 59 | - moba demo 接入见 [moba-demo](../moba-demo/SKILL.md) |
| 60 | - shooter demo 接入见 [shooter-demo](../shooter-demo/SKILL.md) |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
