원클릭으로 Manus에서 모든 스킬 실행

unity-addressables-design

스타21

포크1

업데이트2026년 5월 27일 15:24

Source-anchored design rules for Unity Addressables 1.22.3 (Unity 2022) and 2.9.1 (Unity 6). Load before writing any InitializeAsync / LoadAssetAsync / LoadSceneAsync / UpdateCatalogs / AssetReference code to avoid removed APIs, handle leaks, SceneReleaseMode bugs, and catalog update ordering errors. Triggers: Addressables, AddressableAssets, AddressableAssetSettings, AsyncOperationHandle, LoadAssetAsync, LoadAssetsAsync, LoadSceneAsync, UnloadSceneAsync, InstantiateAsync, GetDownloadSizeAsync, DownloadDependenciesAsync, CheckForCatalogUpdates, UpdateCatalogs, CleanBundleCache, AssetReference, AssetReferenceT, SceneReleaseMode, MergeMode, WaitForCompletion, IResourceLocator, ResourceLocatorInfo, 可寻址资源, 资源加载, 异步操作句柄, 场景加载, 资源更新, 目录更新, 资源引用, 热更新, 资源管理, addressable asset, asset loading, scene management, catalog update, asset reference, handle release, bundle cache.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

dajunctic

dajunctic/TFT-Fake

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

관련 직업SOC

SOC 직업 분류 기준

소프트웨어 개발자컴퓨터 및 수학직·SOC 15-1252

파일 탐색기

9 개 파일

SKILL.md

readonly

이 저장소의 다른 Skills

같은 저장소

unity-skills

dajunctic/TFT-Fake

Unity Editor automation via REST API — create scripts, analyze scenes, manage assets, control editor, orchestrate workflows, run batch jobs, and route by Unity version. Triggers: Unity, Unity Skills, in Unity, automate Unity, Unity editor automation, create Unity script, scene summary, analyze Unity scene, Unity GameObject, Unity prefab, Unity asset, Unity workflow, Unity batch, grant Unity skill, Unity allowlist, Unity skill schema, multi-instance Unity, set Unity version, Unity自动化, Unity编辑器, Unity技能, 操作Unity, 在Unity中, Unity工作流, Unity批处理, Unity授权, Unity白名单, Unity多实例, Unity实例切换, Unity场景分析.

2026-05-2821

unity-adr

dajunctic/TFT-Fake

Architecture decision record helper for Unity projects. Use when users compare options, choose between approaches, or need to lock in a design choice. Triggers: ADR, architecture decision, tradeoff, which approach, compare options, choose pattern, pros and cons, 技术选型, 方案对比, 选哪个, 设计决策, 架构决策, 优缺点对比.

2026-05-2721

unity-animator

dajunctic/TFT-Fake

Unity Animator Controller editing and runtime parameter control: create controllers, add states/transitions/parameters, play animation states, drive triggers/floats/bools. Triggers: animation, animator, Animator Controller, controller, state, state machine, transition, layer, parameter, trigger, float, int, bool, blend tree, animation clip, exit time, has exit time, 动画, 动画控制器, 状态机, 状态, 状态转移, 转移, 图层, 参数, 触发器, 混合树, 动画片段.

2026-05-2721

unity-architecture

dajunctic/TFT-Fake

Gameplay and system architecture advisor for Unity. Use when users want module boundaries, scene design, SOLID structure, decoupling, or refactoring direction before writing code. Triggers: architecture, system design, how to structure, how to organize, module boundary, decouple, refactor, SOLID, 架构设计, 怎么组织代码, 模块划分, 代码结构, 解耦, 重构方向, 系统设计.

2026-05-2721

unity-asmdef

dajunctic/TFT-Fake

Assembly definition advisor for Unity projects. Use when users want module boundaries, faster compilation, cleaner dependencies, or editor/runtime/test separation. Triggers: asmdef, assembly definition, module boundary, compile time, slow compilation, dependency graph, 程序集, 模块边界, 编译慢, 依赖管理, asmdef怎么配.

2026-05-2721

unity-asset

dajunctic/TFT-Fake

Unity asset management. Use when users want to import (external file), delete, move/rename, duplicate, find/search, get info, create folders, refresh AssetDatabase, reimport (single or batch), or read/set asset labels. Triggers: asset, import asset, delete asset, move asset, rename asset, duplicate asset, find asset, search asset, asset info, create folder, refresh assets, reimport, asset labels, AssetDatabase filter, t:Texture2D, l:Label, 资源, 资产, 导入资源, 删除资源, 移动资源, 重命名资源, 复制资源, 查找资源, 资源信息, 创建文件夹, 刷新资源, 重新导入, 资源标签.

2026-05-2721

name

unity-addressables-design

description

Addressables - Design Rules

Advisory module. Every rule is distilled from Unity Addressables source at two versions:

1.22.3 — com.unity.addressables@1.22.3 (Unity 2022, min 2019.4)
2.9.1 — com.unity.addressables@8460f1c9c927 (Unity 6, min 2023.1)

Each rule cites a concrete file/line so the reasoning is auditable and the AI does not improvise against stale memory.

Mode: Documentation only — no REST skills to gate; load freely under any operating mode (Approval / Auto / Bypass).

When to Load This Module

Load before writing or reviewing any of:

Addressables.InitializeAsync() / LoadContentCatalogAsync() bootstrap code
LoadAssetAsync<T> / LoadAssetsAsync<T> / InstantiateAsync and their handle release
LoadSceneAsync / UnloadSceneAsync — especially with SceneReleaseMode (2.9.1)
CheckForCatalogUpdates → UpdateCatalogs → CleanBundleCache patch flow
GetDownloadSizeAsync / DownloadDependenciesAsync / ClearDependencyCacheAsync
AssetReference / AssetReferenceT<T> field declarations and load/release
Any code that calls WaitForCompletion() or uses AsyncOperationHandle directly
Migration from 1.22.3 to 2.9.1 — removed APIs, changed overload signatures

Version Difference Matrix

Area	1.22.3 (Unity 2022)	2.9.1 (Unity 6)
Non-Async variants (`LoadAsset`, `Instantiate`, `LoadScene`, etc.)	`[Obsolete]` — compile warning	Removed — compile error
`IList<object>` multi-key overloads	Present	Replaced by `IEnumerable`
`SceneReleaseMode` enum	Does not exist	New — controls bundle lifetime on scene unload
`LoadSceneAsync` `releaseMode` param	Absent	`SceneReleaseMode.ReleaseSceneWhenSceneUnloaded` default
`LoadAssetsAsync<T>(string key, ...)`	Does not exist	New string-key overload
`UpdateCatalogs(bool autoCleanBundleCache, ...)`	Does not exist	New overload
`LegacyResourcesLocator` / `LegacyResourcesProvider`	Present	Removed
`DiagnosticEvent` / `DiagnosticEventCollector`	Present	Removed
`ResourceManagerEventCollector`	Present	Removed
`ResourceManager.RegisterDiagnosticCallback()`	`[Obsolete]`	Removed
`InitializationOperation` property	`[Obsolete]`, returns `default`	Removed
`BinaryCatalogInitializationData`	Does not exist	New
`CachedFileProvider`	Does not exist	New

Critical Rule Summary

#	Rule	Version	Source anchor
1	All non-Async variants (`LoadAsset`, `Instantiate`, `LoadScene`, `UnloadScene`, `GetDownloadSize`, `DownloadDependencies`, `Initialize`, `LoadContentCatalog`) are `[Obsolete]` in 1.22.3 and removed in 2.9.1. Always use the `*Async` form.	Both	`Addressables.cs:1.22.3:862-2226`, `Addressables.cs:2.9.1` (absent)
2	Every `AsyncOperationHandle` returned by a Load/Instantiate call MUST be released via `Addressables.Release(handle)`. Forgetting leaks the AssetBundle in memory indefinitely — even after the scene unloads.	Both	`AsyncOperationHandle.cs:2.9.1:178-203`
3	`WaitForCompletion()` blocks the calling thread synchronously. On WebGL it is unsupported and throws. Never call it on the main thread in production; use `await handle.Task` or the `Completed` event instead.	Both	`AsyncOperationHandle.cs:2.9.1:178-203`
4	`LoadSceneAsync` in 2.9.1 adds `SceneReleaseMode releaseMode` (default `ReleaseSceneWhenSceneUnloaded`). If a Single-mode load unloads your additive scene and you need the bundle to stay alive, pass `OnlyReleaseSceneOnHandleRelease` and release the handle manually.	2.9.1	`ISceneProvider.cs:2.9.1:14-26`, `Addressables.cs:2.9.1:1914`
5	Multi-key overloads changed from `IList<object>` to `IEnumerable` in 2.9.1. The old `IList<object>` overloads no longer exist — pass `IEnumerable` or `string[]`.	2.9.1	`Addressables.cs:2.9.1:1148,1566,1636`
6	`LegacyResourcesLocator` and `LegacyResourcesProvider` were removed in 2.9.1. Do not reference them in code targeting Unity 6.	2.9.1	`Runtime/ResourceLocators/` (absent in 2.9.1)
7	`ResourceManager.RegisterDiagnosticCallback()` was `[Obsolete]` in 1.22.3 and removed in 2.9.1. Use the Addressables Profiler window instead.	2.9.1	`ResourceManager.cs:1.22.3:353` (absent in 2.9.1)
8	Catalog update flow is strictly ordered: `CheckForCatalogUpdates → UpdateCatalogs`. In 2.9.1, `UpdateCatalogs(bool autoCleanBundleCache, ...)` can auto-clean stale bundles in one call.	Both	`Addressables.cs:2.9.1:2092-2147`
9	`AssetReference.LoadAssetAsync<T>()` returns a handle that must be released via `assetRef.ReleaseAsset()`, NOT `Addressables.Release(handle)`. Mixing the two causes double-release exceptions.	Both	`AssetReference.cs:1.22.3:44-46`
10	`InitializationOperation` property (1.22.3) is `[Obsolete]` and returns `default`. Do not await it. Use `await Addressables.InitializeAsync()` instead.	1.22.3	`Addressables.cs:1.22.3:981-982`

Sub-doc Routing

Sub-doc	When to read
INIT.md	`InitializeAsync` / `LoadContentCatalogAsync` / catalog loading order / `autoReleaseHandle` semantics
HANDLES.md	`AsyncOperationHandle<T>` lifecycle — `Completed`, `WaitForCompletion`, `Release`, `IsDone`, `Status`, `OperationException`, ref-counting
LOADING.md	`LoadAssetAsync`, `LoadAssetsAsync` (all overloads + version diff), `MergeMode`, `InstantiateAsync`, `ReleaseInstance`
SCENE.md	`LoadSceneAsync` / `UnloadSceneAsync` / `SceneInstance.ActivateAsync` / `SceneReleaseMode` (2.9.1) / `activateOnLoad=false` pattern
UPDATE.md	`CheckForCatalogUpdates` → `UpdateCatalogs` flow / `autoCleanBundleCache` (2.9.1) / `CleanBundleCache` / `ResourceLocatorInfo`
DOWNLOAD.md	`GetDownloadSizeAsync` / `DownloadDependenciesAsync` / `ClearDependencyCacheAsync` / `DownloadStatus` struct
ASSETREF.md	`AssetReference` / `AssetReferenceT<T>` / `LoadAssetAsync` / `ReleaseAsset` / `OperationHandle` property / `IsDone` guard
PITFALLS.md	30 concrete hallucination pitfalls with version tags + legacy API migration section

Routing to Other Modules

Asmdef layout for Addressables consumers → load asmdef
Async orchestration across multiple Addressables operations → load async
Architecture-level decisions (Addressables vs YooAsset, group strategy) → load architecture
Performance review of load/release hot paths → load performance

Version Scope

This document targets two versions:

1.22.3 — shipped with Unity 2022 LTS. Contains [Obsolete] non-Async variants still present for migration.
2.9.1 — shipped with Unity 6 (2023.1+). All [Obsolete] APIs removed. New SceneReleaseMode, binary catalog format, AutoGroupGenerator.

When a rule applies to only one version it is tagged [1.22.3] or [2.9.1]. Untagged rules apply to both.

Migration Notes (hallucination shield)

Legacy API	Status	Replacement	Source
`Addressables.Initialize()`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.InitializeAsync()`	`Addressables.cs:1.22.3:862-864`
`Addressables.LoadAsset<T>(key)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.LoadAssetAsync<T>(key)`	`Addressables.cs:1.22.3:992-1007`
`Addressables.LoadAssets<T>(keys, cb, mode)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.LoadAssetsAsync<T>(keys, cb, mode)`	`Addressables.cs:1.22.3:1242-1276`
`Addressables.Instantiate(key, ...)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.InstantiateAsync(key, ...)`	`Addressables.cs:1.22.3:1892-1972`
`Addressables.LoadScene(key, ...)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.LoadSceneAsync(key, ...)`	`Addressables.cs:1.22.3:2090-2106`
`Addressables.UnloadScene(handle, ...)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.UnloadSceneAsync(handle, ...)`	`Addressables.cs:1.22.3:2180-2226`
`Addressables.GetDownloadSize(key)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.GetDownloadSizeAsync(key)`	`Addressables.cs:1.22.3:1547`
`Addressables.DownloadDependencies(key)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`Addressables.DownloadDependenciesAsync(key)`	`Addressables.cs:1.22.3:1608`
`Addressables.InitializationOperation`	`[Obsolete]` in 1.22.3, removed in 2.9.1	`await Addressables.InitializeAsync()`	`Addressables.cs:1.22.3:981-982`
`LoadResourceLocationsAsync(IList<object> keys, ...)`	Present in 1.22.3, removed in 2.9.1	`LoadResourceLocationsAsync(IEnumerable keys, ...)`	`Addressables.cs:2.9.1:1148`
`GetDownloadSizeAsync(IList<object> keys)`	Present in 1.22.3, removed in 2.9.1	`GetDownloadSizeAsync(IEnumerable keys)`	`Addressables.cs:2.9.1:1566`
`DownloadDependenciesAsync(IList<object> keys, mode, ...)`	Present in 1.22.3, removed in 2.9.1	`DownloadDependenciesAsync(IEnumerable keys, mode, ...)`	`Addressables.cs:2.9.1:1636`
`LegacyResourcesLocator` / `LegacyResourcesProvider`	Present in 1.22.3, removed in 2.9.1	Use Addressables groups for all assets	`Runtime/ResourceLocators/LegacyResourcesLocator.cs:1.22.3`
`ResourceManager.RegisterDiagnosticCallback(...)`	`[Obsolete]` in 1.22.3, removed in 2.9.1	Addressables Profiler window	`ResourceManager.cs:1.22.3:353`
`DiagnosticEvent` / `DiagnosticEventCollector`	Present in 1.22.3, removed in 2.9.1	Addressables Profiler / custom IProfilerEmitter	`Runtime/ResourceManager/Diagnostics/:1.22.3`

When in doubt, read the cited source — not your memory.