Unity Addressables Skills

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.

Triggers

• Checking whether Addressables is installed and configured
• Creating Addressables groups and adding assets to them
• Switching the active Addressables profile
• Building Addressables content
• 检查 Addressables 是否安装与配置、创建资源组并添加资源、切换激活 Profile、构建 Addressables 内容

Unity Addressables Skills

Editor-side automation for Addressables — group CRUD, asset entry assignment, profile switching, and the content build. This is the authoring surface (the AddressableAssetSettings asset); runtime loading code is not a skill.

This module holds zero direct references to the package. Every call resolves through reflection against the Unity.Addressables.Editor assembly, so the UnitySkills Editor assembly compiles identically whether or not Addressables is installed — there is no scripting define to set and no recompile needed after installing.

Requires: com.unity.addressables (API anchored to 2.x Editor source; the 1.22.x API surface used here is identical). Companion modules: addressables-design for the runtime loading contract and the 1.22.3 / 2.9.1 migration table, yooasset if the project ships hot updates through YooAsset instead, package to install the package.

Guardrails

Two independent preconditions. Failing either returns a structured error, not a permission denial:

1. Package installed. Without it every skill except addressables_check_installed returns errorCode: "MISSING_PACKAGE" before running (the skills declare com.unity.addressables), with details.missingPackages and a package_install suggested fix.
2. Settings asset created. The package can be installed while AddressableAssetSettings does not yet exist. Every skill except addressables_check_installed then returns errorCode: "TARGET_NOT_FOUND" telling you to create it from Window > Asset Management > Addressables > Groups. There is deliberately no skill for this step — only the Groups window (or a human) can create the settings singleton.

Always call addressables_check_installed first. It is the only skill that works in both failure states, and its installed / configured pair tells you which precondition is missing.

Operating Mode (v1.9 three-tier):

• SemiAuto — addressables_check_installed, addressables_group_list, addressables_profile_get run directly in all three modes without a grant.
• FullAuto — addressables_group_create, addressables_group_add_entry, addressables_profile_set, addressables_build need a user grant under Approval (grant triggers one server-side execute returning the result); under Auto / Bypass they run directly with audit only.
• Auto-forbidden (NeverInSemi, SkillOperation.Delete) — addressables_group_delete returns MODE_FORBIDDEN under Approval and Auto. Only Bypass or a user-managed Allowlist entry can run it; never attempt a grant for it.

DO NOT (these skills do NOT exist — do not invent them):

• addressables_group_remove_entry / addressables_entry_list / addressables_entry_set_address — there is no entry-removal, entry-listing or address-rename skill. addressables_group_list reports only entryCount per group. Move an entry with addressables_group_add_entry; to inspect or remove individual entries use the Addressables Groups window.
• addressables_profile_create / addressables_profile_set_variable — profiles can be selected but not created or edited here.
• addressables_group_set_schema / addressables_analyze / addressables_clean_build — group schema editing, the Analyze rules and cache cleaning are not exposed.
• addressables_settings_create — see precondition 2; the settings asset cannot be created from a skill.

Routing:

• Addressables group / entry / profile authoring and content build → this module.
• Runtime Addressables.LoadAssetAsync handle lifecycle, AssetReference usage, catalog updates → addressables-design (documentation only; write the code yourself).