unity-addressables-design

1> **Before calling any skill in this module:** if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via `GET /skills/recommend?includeSchema=true`) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
2 
3## Triggers
4- Writing or reviewing Addressables code
5- Async asset/scene loading
6- Hot-update or catalog refresh
7- Version migration
8- 编写或审查 Addressables 代码、异步加载资源/场景、配置热更新或目录刷新、版本迁移
9 
10# Addressables - Design Rules
11 
12Advisory module. Every rule is distilled from Unity Addressables source at two versions:
13- **1.22.3** — `com.unity.addressables@1.22.3` (Unity 2022, min 2019.4)
14- **2.9.1** — `com.unity.addressables@8460f1c9c927` (Unity 6, min 2023.1)
15 
16Each rule cites a concrete file/line so the reasoning is auditable and the AI does not improvise against stale memory.
17 
18> **Mode**: Documentation only — no REST skills to gate; load freely under any operating mode (Approval / Auto / Bypass).
19 
20## When to Load This Module
21 
22Load before writing or reviewing any of:
23 
24- `Addressables.InitializeAsync()` / `LoadContentCatalogAsync()` bootstrap code
25- `LoadAssetAsync<T>` / `LoadAssetsAsync<T>` / `InstantiateAsync` and their handle release
26- `LoadSceneAsync` / `UnloadSceneAsync` — especially with `SceneReleaseMode` (2.9.1)
27- `CheckForCatalogUpdates` → `UpdateCatalogs` → `CleanBundleCache` patch flow
28…