Agent Skills
› IvanMurzak/Unity-MCP
IvanMurzak/Unity-MCP
GitHub用于构建 unity-mcp-cli TypeScript CLI 工具，包括安装依赖、编译代码、全局链接及版本验证，确保工具可正常使用。
Install All Skills
npx skills add IvanMurzak/Unity-MCP --all -g -y
Skills in Collection (80)
Showing top 50 of 80 by quality score. Use the install list command or open individual skills for the rest.
用于构建 unity-mcp-cli TypeScript CLI 工具，包括安装依赖、编译代码、全局链接及版本验证，确保工具可正常使用。
需要构建或更新 CLI 工具
首次安装并链接 CLI 到全局环境
验证 CLI 工具是否安装成功
npx skills add IvanMurzak/Unity-MCP --skill build-cli -g -y
自动审查 GitHub PR 中的未解决评论，验证其合理性后直接修复代码问题。通过子代理并行处理不同文件的修改，同文件顺序执行以避免冲突，提升代码审查效率。
用户要求审查并修复 PR 评论
当前分支关联的 PR 存在未解决的代码审查意见
npx skills add IvanMurzak/Unity-MCP --skill github-pr-review-fix -g -y
用于在Unity项目中按指定路径批量复制资源文件，并自动刷新AssetDatabase。支持源与目标路径的一对多映射，错误累积处理，常配合assets-find使用以定位源资源。
用户需要将资源从一处复制到另一处
需要批量移动或备份项目中的资产文件
npx skills add IvanMurzak/Unity-MCP --skill assets-copy -g -y
在Unity项目的Assets目录下创建新文件夹，支持批量操作与路径校验，自动刷新资源数据库并返回GUID。
用户需要在Unity项目中创建新的文件夹结构
用户需要批量创建多个文件夹以组织脚本或资源
npx skills add IvanMurzak/Unity-MCP --skill assets-create-folder -g -y
用于在Unity项目中按路径批量删除资源文件，并刷新AssetDatabase。支持原子删除及错误/成功结果反馈，需配合assets-find定位目标。
需要清理项目中的无用或废弃资源
批量移除指定路径下的资产文件
npx skills add IvanMurzak/Unity-MCP --skill assets-delete -g -y
用于在Unity编辑器内置资源中搜索资产，支持按名称和类型过滤，结果按匹配质量排序。
查找Unity内置资产
根据名称或类型筛选内置资源
npx skills add IvanMurzak/Unity-MCP --skill assets-find-built-in -g -y
在Unity资产数据库中通过名称、标签、类型等过滤器搜索资源，支持限定文件夹和结果数量。
用户需要查找特定的Unity资源文件
根据资源类型或标签筛选资产列表
npx skills add IvanMurzak/Unity-MCP --skill assets-find -g -y
用于从Unity项目中读取资产文件数据，支持获取所有可序列化字段或按路径/视图查询精确提取。需先使用assets-find定位资产。
需要读取Unity资产（如Prefab、Material）的完整结构或特定属性值
通过路径语法或视图查询高效提取资产中的嵌套数据以节省token
npx skills add IvanMurzak/Unity-MCP --skill assets-get-data -g -y
用于在Unity项目中创建材质资产，支持自动创建缺失的中间文件夹。需指定Assets/开头的路径和有效的Shader名称，返回新资产的引用信息。
需要创建新的Unity材质文件
根据指定Shader生成默认材质资产
npx skills add IvanMurzak/Unity-MCP --skill assets-material-create -g -y
用于修改Unity项目中Assets目录下的资产文件，支持content、pathPatches和jsonPatch三种修改方式，需先使用assets-get-data检查结构。
需要修改Unity资产文件内容或路径时
对Material、Prefab等资产进行批量或精确更新时
npx skills add IvanMurzak/Unity-MCP --skill assets-modify -g -y
用于在Unity项目中移动或重命名资源文件，并刷新资源数据库。支持批量操作，返回成功路径和错误信息。需配合assets-find使用。
需要移动或重命名Unity项目中的资源文件
批量调整资源路径结构
npx skills add IvanMurzak/Unity-MCP --skill assets-move -g -y
用于关闭Unity编辑器中当前打开的Prefab编辑阶段，支持在关闭前选择保存更改或丢弃未保存内容。
用户完成Prefab编辑并需要退出编辑模式
用户希望关闭当前的Prefab资产编辑窗口
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-close -g -y
在Unity项目中指定路径创建Prefab或Prefab Variant，支持从场景GameObject或现有Prefab资产生成，自动创建中间文件夹并返回资源引用。
需要从场景对象创建预制体
需要基于现有预制体创建变体
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-create -g -y
在Unity场景中实例化预制体，支持指定位置、旋转、缩放及父级路径。用于场景构建和对象生成任务。
需要在场景中创建预制体实例
根据路径实例化GameObject并设置变换属性
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-instantiate -g -y
Unity工具，用于打开预制体编辑模式。支持实例与资产，修改同步至所有实例，需配合关闭工具使用。
需要编辑或修改Unity预制体时
对场景中的预制体实例进行修改
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-open -g -y
在Unity编辑器中保存当前预制体编辑阶段的内容，无需退出编辑模式。需先使用assets-prefab-open打开预制体，调用后返回资产引用。
用户需要在Unity中保存已修改的预制体
完成预制体编辑后需要持久化更改
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-save -g -y
刷新Unity资源数据库，支持外部文件变更同步及脚本强制重新编译。处理异步编译状态并返回结果，用于维护项目资源一致性。
在Unity API之外添加或更新了项目文件
.cs文件变更需要强制脚本重新编译
npx skills add IvanMurzak/Unity-MCP --skill assets-refresh -g -y
获取Unity项目中Shader资产的详细数据，包括属性、子着色器、编译消息及支持状态。支持通过路径或视图查询节省Token的局部读取，辅助排查渲染问题。
需要查看Unity Shader的具体结构和属性
调试Shader编译错误或性能问题
分析Shader支持的渲染特性
npx skills add IvanMurzak/Unity-MCP --skill assets-shader-get-data -g -y
列出项目中所有可用的着色器名称，按字母排序。主要用于发现有效的着色器名，以便在创建材质时作为参数使用。
需要查找项目中的着色器列表
为创建材质准备着色器名称
npx skills add IvanMurzak/Unity-MCP --skill assets-shader-list-all -g -y
清除Unity编辑器控制台和MCP日志缓存，用于在特定操作前隔离日志，便于排查错误。
需要隔离日志以排查特定操作导致的错误
清理Unity Editor Console窗口和MCP日志缓存
npx skills add IvanMurzak/Unity-MCP --skill console-clear-logs -g -y
从 Unity Editor 的 LogCollector 检索日志，支持按类型、时间窗口过滤及包含堆栈跟踪。主要用于调试和监控编辑器活动状态。
需要查看 Unity 编辑器控制台日志
排查编辑器运行时的错误或警告
监控特定时间段内的日志输出
npx skills add IvanMurzak/Unity-MCP --skill console-get-logs -g -y
获取Unity编辑器当前状态，包括播放模式、暂停、编译及更新等标志位信息。
需要查询Unity编辑器运行状态
检查脚本编译或资源数据库刷新状态
npx skills add IvanMurzak/Unity-MCP --skill editor-application-get-state -g -y
控制Unity编辑器的播放模式状态，支持启动、停止或暂停。在脚本编译失败时会拒绝操作并抛出错误，成功则返回编辑器状态快照。
需要启动或停止Unity编辑器播放模式
需要暂停或恢复Unity编辑器播放模式
npx skills add IvanMurzak/Unity-MCP --skill editor-application-set-state -g -y
获取Unity编辑器中当前选中的对象信息，包括GameObject、Transform、实例ID和资源GUID等。支持按需启用不同字段以优化响应大小，常与设置选择的工具配合使用。
查询Unity编辑器当前选中状态
获取场景或项目中选定对象的详细信息
npx skills add IvanMurzak/Unity-MCP --skill editor-selection-get -g -y
在Unity编辑器中将指定对象设置为当前选中状态，并刷新视图。用于自动化场景编辑或资源管理流程中的选择操作。
用户需要将特定GameObject或Asset设为选中状态
需要批量选择多个Unity对象进行后续操作
npx skills add IvanMurzak/Unity-MCP --skill editor-selection-set -g -y
用于在Unity编辑器中向指定GameObject添加组件，支持批量操作及错误累积处理。
需要在Prefab或场景中为GameObject添加新组件
需要批量添加多个组件到特定游戏对象
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-add -g -y
用于在Unity中销毁指定GameObject上的一个或多个组件。通过匹配组件引用列表，跳过空值并调用DestroyImmediate执行销毁操作，若未找到匹配组件则抛出异常。
需要移除Unity GameObject上的特定脚本或组件时
清理场景或预制体中不需要的组件实例时
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-destroy -g -y
获取Unity GameObject中指定组件的详细信息，包括类型、启用状态及序列化字段。支持通过路径或视图查询节省Token，用于在修改前检查组件数据。
需要查看Unity组件的详细属性
检查GameObject上的特定组件状态
读取组件的序列化字段
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-get -g -y
列出Unity项目中所有UnityEngine.Component子类的完整C#类型名，支持分页和搜索过滤。主要用于查找有效的组件名称，以便配合其他工具添加组件到GameObject。
需要查找Unity中可用的组件类型名称时
为gameobject-component-add工具准备参数时
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-list-all -g -y
用于修改Unity场景中或Prefab内GameObject组件属性的技能，支持三种补丁方式。
需要修改Unity GameObject组件字段
批量更新游戏对象属性
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-modify -g -y
在Unity场景中创建新GameObject，支持指定名称、父对象及变换属性，并可生成基本几何体。
需要在Unity场景或Prefab中创建新的游戏对象
需要基于基本形状（如立方体、球体）实例化GameObject
npx skills add IvanMurzak/Unity-MCP --skill gameobject-create -g -y
在Unity编辑器中销毁指定GameObject及其所有子对象，支持Prefab或场景。通过验证引用并调用DestroyImmediate执行操作，返回被销毁对象的名称、路径和实例ID以供确认。
需要删除游戏对象
清理场景或预制体中的无用组件
npx skills add IvanMurzak/Unity-MCP --skill gameobject-destroy -g -y
用于在Unity的Prefab或场景中批量复制GameObject，自动标记场景为脏状态以保存更改。需先使用gameobject-find定位源对象，支持通过CLI传递输入参数。
需要复制Unity场景中的游戏对象
批量克隆Prefab或场景内的GameObject
npx skills add IvanMurzak/Unity-MCP --skill gameobject-duplicate -g -y
在Unity编辑器中查找指定GameObject，支持Prefab或场景。可返回组件、边界及层级信息，支持路径过滤以节省Token，用于游戏对象定位与数据预览。
需要查找特定GameObject
获取GameObject的组件或层级信息
查看Prefab或场景中的对象属性
npx skills add IvanMurzak/Unity-MCP --skill gameobject-find -g -y
用于在Unity场景中批量修改GameObject字段和属性，支持三种补丁方式：完整差异、路径补丁和JSON合并补丁。
需要批量修改Unity GameObject属性
需要通过脚本或CLI更新Prefab或场景对象状态
npx skills add IvanMurzak/Unity-MCP --skill gameobject-modify -g -y
用于在Unity中批量将多个GameObject重新指定父节点，支持Prefab或场景操作，保留世界坐标变换，并报告逐项失败状态。
批量调整游戏对象层级结构
Unity编辑器中修改GameObject父子关系
npx skills add IvanMurzak/Unity-MCP --skill gameobject-set-parent -g -y
用于获取Unity UnityEngine.Object的序列化数据，支持全量或按路径/视图查询读取字段和属性。
需要读取Unity对象属性值
调试Unity场景中的对象状态
分析Unity组件数据结构
npx skills add IvanMurzak/Unity-MCP --skill object-get-data -g -y
用于修改 Unity UnityEngine.Object 的可序列化字段和属性。支持三种修改方式：objectDiff、pathPatches 和 jsonPatch，可灵活调整对象状态。
需要修改 Unity 游戏对象或组件的属性值
通过脚本批量更新场景对象的状态
npx skills add IvanMurzak/Unity-MCP --skill object-modify -g -y
用于在Unity项目中通过包管理器安装指定包，支持从注册表、Git或本地路径添加，自动修改manifest.json并处理域重载。
用户请求安装Unity包
需要向项目添加第三方或官方插件
npx skills add IvanMurzak/Unity-MCP --skill package-add -g -y
列出 Unity 项目中所有已安装的 UPM 包信息，支持按来源、名称及依赖类型筛选。用于在添加或移除包前检查当前环境状态。
查询 Unity 项目已安装的包列表
检查特定来源或名称的 UPM 包
查看直接依赖而非传递依赖的包
npx skills add IvanMurzak/Unity-MCP --skill package-list -g -y
从Unity项目中卸载指定UPM包，修改manifest.json并触发域重载。适用于移除不再需要的依赖或清理项目结构。
用户要求卸载Unity包
需要清理Unity项目中的冗余包
npx skills add IvanMurzak/Unity-MCP --skill package-remove -g -y
用于在Unity包管理器中搜索包，支持本地和在线注册表。通过名称、描述等关键词查找可用版本及安装状态，辅助开发者在添加依赖前进行检索。
查询Unity包是否可用
查找特定功能的包
检查本地已安装包
npx skills add IvanMurzak/Unity-MCP --skill package-search -g -y
轻量级就绪探针，用于 CLI 健康检查及 SignalR 连通性冒烟测试。支持回显输入消息或默认返回 pong，用于测量往返延迟或确认 MCP 传输通道活跃状态。
需要检测服务或连接是否存活时
进行 CLI 健康检查或连通性测试时
npx skills add IvanMurzak/Unity-MCP --skill ping -g -y
用于在Unity中捕获当前帧的性能数据快照，包括FPS、帧时间、总帧数及启动时间等指标。
需要获取当前帧性能数据
监控游戏运行时的FPS和延迟
npx skills add IvanMurzak/Unity-MCP --skill profiler-capture-frame -g -y
用于Unity编辑器Profiler工具，清空当前持有的所有性能分析帧数据。调用后可重置录制历史，使后续记录从第0帧开始，适用于需要重新采集性能数据的场景。
需要重置Unity Profiler录制历史时
清除旧的性能分析帧数据以开始新的测试
npx skills add IvanMurzak/Unity-MCP --skill profiler-clear-data -g -y
用于在本地维护 Unity Profiler 模块的启用状态，支持按名称标记指定模块为启用或禁用。该操作仅涉及本地数据记录，不直接调用运行时 API，需配合其他工具使用以获取实际性能数据。
需要启用或禁用特定 Unity Profiler 模块时
配置性能分析工具集时
npx skills add IvanMurzak/Unity-MCP --skill profiler-enable-module -g -y
获取Unity Profiler内存统计快照，包括保留、分配、Mono堆、图形等内存数据（MB）。用于性能分析和内存监控。
查询Unity游戏运行时内存使用情况
分析内存泄漏或性能瓶颈
监控特定场景下的资源占用
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-memory-stats -g -y
从Unity内置API获取帧耗时、FPS、垂直同步、目标帧率及图形设备类型等渲染性能指标，用于实时监控游戏运行状态。
查询当前游戏帧率和性能数据
诊断渲染卡顿或性能瓶颈
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-rendering-stats -g -y
获取Unity脚本执行统计信息，包括帧时间、固定增量时间、时间缩放、总帧数、启动后实时时间以及Mono和GC内存使用情况。
需要监控Unity应用性能指标
查询当前帧率和内存占用情况
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-script-stats -g -y
获取Unity Profiler当前状态，包括启用状态、活跃模块、最大内存使用及平台支持情况。仅读取内置API数据，用于性能监控和调试前置检查。
查询Unity运行时Profiler状态
检查Profiler是否启用或受支持
获取当前内存使用情况
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-status -g -y
