unity-package（Unity package 搜索）

Package Skills

Manage installed Unity packages and package-related helper flows such as Cinemachine and Splines setup.

Guardrails

Mode: Full-Auto required

DO NOT (common hallucinations):

• package_add / package_update do not exist -> use package_install
• package_get_info does not exist -> use package_list, package_check, package_get_dependencies, or package_get_versions
• package_search searches the installed package cache only; it does not query the Unity Registry
• package_list, package_search, package_get_dependencies, and package_get_versions can return "Package list not ready" until package_refresh completes
• Package install/remove/refresh jobs can trigger package import and Domain Reload; expect transient server unavailability and use returned job IDs

Routing:

• For Cinemachine quick setup -> use package_install_cinemachine
• For Splines quick setup -> use package_install_splines
• For project manifest inspection -> use project_get_packages
• For define symbol changes after package installation -> use debug_set_defines

Skills

package_list

List all installed packages currently cached by UnitySkills. Parameters: None.

Returns: {success, count, packages}

package_check

Check whether a package is installed.

Returns: {packageId, installed, version}

package_install

Install a package. Returns an async job when the request is accepted.

Returns: {success, status, jobId, message, serverAvailability}

package_remove

Remove an installed package. Returns an async job when the request is accepted.

Returns: {success, status, jobId, message, serverAvailability}

package_refresh

Refresh the installed package cache used by query skills. Parameters: None.

Returns: {success, status, jobId, message}

package_install_cinemachine

Install Cinemachine using the supported package/version strategy.

Notes:

• CM3 auto-installs the Splines dependency.
• If the requested line is already installed, this skill can return immediate success instead of a job.

Returns: {success, status?, jobId?, message, serverAvailability?}

package_install_splines

Install or upgrade Unity Splines using the recommended version for the current Unity editor line. Parameters: None.

Returns: {success, status?, jobId?, message, serverAvailability?}

package_get_cinemachine_status

Get current Cinemachine and Splines installation status. Parameters: None.

Returns: {cinemachine, splines}

package_search

Search the installed package cache by package name or display name.

Returns: {success, query, count, packages}

package_get_dependencies

Get dependency information for one installed package.

Returns: {success, packageId, version, dependencyCount, dependencies}

package_get_versions

Get available versions for one installed package.

Returns: {success, packageId, currentVersion, compatibleVersion, latestVersion, allVersions}

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.