Agent Skills
› Besty0728/Unity-Skills
Besty0728/Unity-Skills
GitHub提供 Unity Addressables 1.22.3 与 2.9.1 的设计规则，涵盖异步加载、热更新及版本迁移。基于源码提炼审计性规范，辅助代码编写审查，防止 API 误用。
Install All Skills
npx skills add Besty0728/Unity-Skills --all -g -y
Skills in Collection (82)
Showing top 50 of 82 by quality score. Use the install list command or open individual skills for the rest.
提供 Unity Addressables 1.22.3 与 2.9.1 的设计规则，涵盖异步加载、热更新及版本迁移。基于源码提炼审计性规范，辅助代码编写审查，防止 API 误用。
编写或审查 Addressables 代码
异步资源/场景加载实现
配置热更新或目录刷新逻辑
Addressables 版本迁移
npx skills add Besty0728/Unity-Skills --skill unity-addressables-design -g -y
Unity Addressables 编辑器侧自动化技能，支持检查安装配置、管理资源组与条目、切换 Profile 及构建内容。通过反射调用 API，无需重新编译，提供结构化错误处理与权限控制。
检查 Addressables 是否安装与配置
创建 Addressables 资源组并添加资源
切换激活的 Addressables Profile
构建 Addressables 内容
npx skills add Besty0728/Unity-Skills --skill unity-addressables -g -y
用于记录Unity架构决策（ADR），涵盖技术选型、库对比及设计理由，确保决策可追溯并明确后续重审触发条件。
技术方案选型
库或模式对比
记录设计决策来龙去脉
npx skills add Besty0728/Unity-Skills --skill unity-adr -g -y
提供Unity Animator控制技能，支持创建控制器、管理状态机与参数、分配控制器及运行时驱动动画。涵盖查询与变更操作，适用于搭建或调整Animator及相关逻辑的开发任务。
设置或连接Animator
调整动画状态机
运行时驱动动画参数
npx skills add Besty0728/Unity-Skills --skill unity-animator -g -y
用于管理Unity行为图资产、连接AI代理及读写黑板变量，支持NPC/AI决策逻辑搭建与运行时图操作。
搭建 NPC/AI 决策逻辑
使用行为树/行为图
读写黑板变量
npx skills add Besty0728/Unity-Skills --skill unity-behavior -g -y
为Unity小型游戏或垂直切片提供轻量级架构蓝图建议，涵盖核心循环、场景模块及脚本清单，适用于从零开始搭建2D平台、射击等类型游戏结构。
从零开始做小游戏
搭建某类型核心结构
组织特定玩法
npx skills add Besty0728/Unity-Skills --skill unity-blueprints -g -y
用于在Unity编辑器中配置和修改UnityEvent的持久化监听器，支持查询、添加、设置及调用事件回调，适用于UI按钮或触发器的脚本化连接。
在Inspector中挂接UnityEvent
连接按钮或触发器回调
脚本化持久监听
npx skills add Besty0728/Unity-Skills --skill unity-event -g -y
用于管理Unity项目全局图形设置和质量配置，支持URP/HDRP等渲染管线。涵盖查询画质、切换质量等级、指定SRP资产及Shader剥离配置等功能。
配置工程图形/画质设置
指定 SRP 资产
调整质量等级
npx skills add Besty0728/Unity-Skills --skill unity-graphics -g -y
管理Unity编辑器撤销/重做历史，支持查看当前组、逐步撤销和重做操作，提供API接口以审查改动。
查看或浏览撤销历史
逐步撤销/重做
审查改动
npx skills add Besty0728/Unity-Skills --skill unity-history -g -y
指导用户在Unity编辑器中手动添加、配置、重排和复制GameObject组件，适用于单次Inspector操作。
向GameObject添加单个组件
在Inspector中调整组件字段
重排对象上的组件顺序
复制组件值到另一对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-component -g -y
提供Unity编辑器中手动创建、组织层级和调整变换的逐步操作指南。适用于少量对象的快速编辑，区分于批量自动化任务，指导用户通过UI完成GameObject管理。
在Unity编辑器中手动创建单个游戏对象
在游戏对象层级中进行父子关系调整或排序
通过检查器或场景视图移动、旋转或缩放对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-gameobject -g -y
提供 Unity 编辑器中手动创建、编辑材质及分配对象的步骤指导，适用于少量单次调整。
创建新材质资产
修改材质颜色或着色器
将材质拖拽到 MeshRenderer
npx skills add Besty0728/Unity-Skills --skill unity-manual-material -g -y
提供 Unity Editor 中场景视图的手动操作指南，包括视角旋转、平移、缩放、聚焦对象及切换 2D/正交视图。涵盖保存场景、打开场景及 additive 工作流等基础 UI 操作指引。
需要手动导航或管理 Unity 场景视图
询问如何在编辑器中保存或切换场景
npx skills add Besty0728/Unity-Skills --skill unity-manual-scene -g -y
用于在Unity中编辑材质和Shader属性，支持Built-in/URP/HDRP管线。提供创建、分配、修改颜色/纹理/参数及批量操作技能，并包含防止幻觉的防护指南和安全操作建议。
调整物体外观
修改材质参数
切换Shader
npx skills add Besty0728/Unity-Skills --skill unity-material -g -y
提供 Unity Netcode for GameObjects 2.x 的设计规则与最佳实践，涵盖网络行为脚本、RPC、变量及传输配置等核心模块的源码级规范，辅助多人联机代码的编写、审查与调试。
编写或审查多人联机代码
设计服务器/分布式权威逻辑
连接 RPC 或网络变量
排查 netcode 相关问题
npx skills add Besty0728/Unity-Skills --skill unity-netcode-design -g -y
自动化配置和运维 Unity Netcode for GameObjects (NGO) 多人联机功能，涵盖预制体注册、生成逻辑及服务器/客户端启动。
搭建多人联机
注册网络预制体
连接生成逻辑
启动 host/server/client
npx skills add Besty0728/Unity-Skills --skill unity-netcode -g -y
提供Unity场景与项目的只读分析能力，涵盖结构审查、健康检查及脚本依赖分析。主要用于编辑前收集上下文、理解陌生项目或审计结构，支持自动路由以辅助开发决策。
编辑前收集上下文
理解陌生场景或项目
在不改动的前提下审查结构
npx skills add Besty0728/Unity-Skills --skill unity-perception -g -y
提供PICO Unity SDK v3.4.0的设计规则与避坑指南，解决AI生成代码时的幻觉问题。涵盖环境搭建、渲染交互、平台服务及版本迁移，确保XR应用正确开发。
编写或审查PICO Unity SDK代码
配置PICO XR项目或OpenXR插件路线
实现视频透视/空间锚点/MR功能
从SDK 2.x或旧版3.x迁移至v3.4.0
npx skills add Besty0728/Unity-Skills --skill unity-pico-design -g -y
用于检查 PrimeTween 安装状态、探索动画 API 并生成 Transform/Sequence 动画 C# 脚本的工具。支持查询配置和列出工厂方法，但生成脚本因触发重载被限制，需特殊权限。
检查 PrimeTween 安装状态
探索支持的动画 API
生成 Transform 或 Sequence 动画代码
npx skills add Besty0728/Unity-Skills --skill unity-primetween -g -y
用于Unity ProBuilder模块，支持关卡灰盒搭建、几何体创建与编辑及原型快速搭形。提供批量创建、面操作等功能，内置权限控制与安全护栏，适用于3D场景建模流程。
搭建关卡灰盒
创建或编辑ProBuilder几何体
在编辑器内快速搭形
npx skills add Besty0728/Unity-Skills --skill unity-probuilder -g -y
提供Unity运行时性能快照读取能力，涵盖FPS、内存及资源统计。仅支持只读查询，用于排查性能瓶颈与资源占用情况。
查看运行时性能
抓取 profiler 快照
检查内存/帧率统计
npx skills add Besty0728/Unity-Skills --skill unity-profiler -g -y
用于在建议Unity项目架构变更前，先对项目现状进行侦察和审计。收集版本、依赖、代码结构及现有模式等信息，识别风险与约束，为后续改动提供技术基线。
初次接触陌生项目
提结构性改动前
盘点现有配置
npx skills add Besty0728/Unity-Skills --skill unity-project-scout -g -y
提供用于测试 API 连通性和可达性的示例技能，包括创建、删除和查询 GameObject 的基础操作。主要用于冒烟测试和首次调用验证，非生产用途。
测试 REST 服务可达性
冒烟测试连通性
试发第一个调用
npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y
提供 Unity Shader Graph 的设计规则与最佳实践，基于源码验证推荐节点、SubGraph 结构及 URP/HDRP 配方。用于指导新图设计、审查节点链及配置黑板属性，确保建议符合当前技能集限制。
构建或审查 Shader Graph
组织节点链或 SubGraph
布置黑板/关键字
参考 URP/HDRP 图配方
npx skills add Besty0728/Unity-Skills --skill unity-shadergraph-design -g -y
Unity技能模块索引，提供模块目录浏览、任务路由及执行模式（SA/FA/Mixed）查询，辅助用户选择合适模块并加载文档。
浏览模块目录
查找某事由哪个模块处理
确认模式要求
npx skills add Besty0728/Unity-Skills --skill unity-skills-index -g -y
Unity场景智能辅助技能集，支持按条件或空间查询对象、自动排布布局及绑定引用。提供只读查询与需授权的全自动变换功能，旨在提升3D场景编辑效率。
按条件或邻近关系查询场景对象
自动排布对象
自动连线引用
npx skills add Besty0728/Unity-Skills --skill unity-smart -g -y
指导使用实验性 Unity CLI 的 Skill，用于在编辑器关闭时通过本地 Shell 执行项目操作。需检查配置文件启用状态及功能开关，强调以 --help 为准并处理版本差异。
用户需要使用 Unity CLI 进行自动化操作
需要绕过 REST API 直接在本地运行 Unity 命令
Unity Editor 处于关闭状态但需执行任务
npx skills add Besty0728/Unity-Skills --skill unity-cli -g -y
Unity YAML手动编辑指南，用于REST API不可达时的最后手段。涵盖修复GUID/fileID引用、.meta文件及合并冲突，强调仅在编译失败或无API时使用。
REST无法触达时手编YAML
修复m_Script GUID或断裂fileID引用
修复.meta文件或处理合并冲突
npx skills add Besty0728/Unity-Skills --skill unity-yaml-editing -g -y
通过本地 REST API 自动化 Unity 编辑器，支持脚本创建、场景构建、资产管理和批量操作。适用于需直接驱动编辑器执行具体任务的场景，而非概念问答。
用户要求从对话中实际操作 Unity 编辑器
需要创建或修改 GameObjects、脚本、场景或资产
执行批量编辑任务
运行编辑器测试
npx skills add Besty0728/Unity-Skills --skill unity-skills -g -y
针对Unity项目提供游戏与系统架构设计建议，涵盖代码组织、职责划分、解耦及重构方向，旨在避免过度工程化并优化启动顺序与数据所有权。
规划代码结构
划分职责
降低耦合
确定重构方向
npx skills add Besty0728/Unity-Skills --skill unity-architecture -g -y
针对大型Unity项目，提供程序集定义(asmdef)的规划建议，包括结构拆分、依赖梳理、编译加速及编辑器/运行时隔离方案。
规划 asmdef 结构
理顺程序集依赖
加速编译
拆分编辑器/运行时代码
npx skills add Besty0728/Unity-Skills --skill unity-asmdef -g -y
管理Unity AssetDatabase操作，包括资源导入、移动、删除、重命名及元数据查询。支持单文件与批量操作，提供审批与安全模式控制，防止误删或高危写入。
整理工程资源
导入或移动文件
查询资源元数据
脚本化AssetDatabase操作
npx skills add Besty0728/Unity-Skills --skill unity-asset -g -y
提供Unity运行时异步代码（Update、协程、UniTask等）的策略建议，指导在定时调度、取消处理和生命周期管理中的技术选型与最佳实践。
在Update、协程、UniTask或定时器之间进行技术选型
处理异步任务的取消逻辑和资源清理
npx skills add Besty0728/Unity-Skills --skill unity-async -g -y
提供Unity批量操作与异步任务编排能力，支持多步骤顺序执行、预览提交及事务回滚。通过单次HTTP调用串联多个技能，减少往返延迟，适用于大量对象操作及长时任务处理。
一次性操作大量对象
运行或轮询长时异步任务
先预览后提交的批量编辑
npx skills add Besty0728/Unity-Skills --skill unity-batch -g -y
管理Unity场景视角书签，支持保存、恢复、列出和删除相机位置及选中对象状态，辅助快速导航已收藏的场景机位。
保存或恢复场景视角
收藏机位
在已存位置间切换
npx skills add Besty0728/Unity-Skills --skill unity-bookmark -g -y
用于控制 Unity 编辑器场景视图和游戏中相机的技能模块，支持创建、调整位置、属性、截图及裁剪面等操作。
取景 Scene View
创建或调整相机
修改 FOV 或裁剪面
npx skills add Besty0728/Unity-Skills --skill unity-camera -g -y
用于在Unity中配置Cinemachine虚拟相机，包括创建、调校跟随注视噪声及构建运镜效果。支持2.x与3.x版本，通过反射适配器兼容API差异，提供查询与配置能力。
创建或调校Cinemachine相机
设置跟随/注视/噪声参数
构建 cinematic 运镜效果
npx skills add Besty0728/Unity-Skills --skill unity-cinemachine -g -y
用于Unity项目的清理与审计，支持查找未使用资产、重复文件、孤立引用及大文件，提供发布前瘦身和合规检查能力。
给项目瘦身
排查重复或孤立资源
发布前审计
npx skills add Besty0728/Unity-Skills --skill unity-cleaner -g -y
管理Unity GameObject组件，支持挂载、移除、复制、属性读写及批量操作。提供组件列表查询与开关控制，规范API调用避免幻觉，强调批量处理以提升效率并处理高危删除权限。
挂载或移除组件
在对象间复制组件
开关组件
读写序列化字段
npx skills add Besty0728/Unity-Skills --skill unity-component -g -y
提供Unity编辑器控制台的日志捕获、查询、过滤、导出及配置管理功能，辅助开发者查看输出和调试项目。
查看控制台输出
过滤错误或警告
输出日志
配置控制台
npx skills add Besty0728/Unity-Skills --skill unity-console -g -y
提供Unity编辑器调试与诊断工具，支持编译状态检查、错误日志获取及系统信息收集。用于排查编译失败、改动后报错及强制重编译等场景。
诊断编译失败
检查改动后的报错
强制重新编译
收集系统诊断信息
npx skills add Besty0728/Unity-Skills --skill unity-debug -g -y
用于在Unity URP中创建、配置和管理Decal Projector，包括启用渲染特性及查询状态。
在URP中添加贴花
配置Decal Projector
启用Decal Renderer Feature
npx skills add Besty0728/Unity-Skills --skill unity-decal -g -y
提供 Unity DOTween 1.3.015 的设计规范，基于源码提炼初始化、序列构建、生命周期管理及调试规则，辅助代码编写与审查。
编写或审查 DOTween 代码
构建动画序列
绑定补间生命周期
排查补间陷阱
npx skills add Besty0728/Unity-Skills --skill unity-dotween-design -g -y
提供Unity DOTween插件的自动化配置、诊断、模块发现及运行时脚本生成功能，支持Free/Pro版本设置与组件校验。
接入DOTween
校验安装/模块
配置DOTweenAnimation组件
npx skills add Besty0728/Unity-Skills --skill unity-dotween -g -y
提供Unity编辑器状态观测与控制能力，支持场景变更读取、Play Mode操控、运行时检查及菜单执行。包含安全模式限制与常见幻觉规避指南，旨在无需解析YAML即可高效管理编辑器交互。
读取持久化场景/文件变更
操控 Play Mode
检查运行时状态
执行菜单项
npx skills add Besty0728/Unity-Skills --skill unity-editor -g -y
用于在Unity中创建、删除、复制、重命名GameObject，调整层级关系及Transform属性。提供批量操作优化API调用，并指导正确路由至组件或材质模块。
搭建或调整场景层级
新建或删除物体
修改Transform
npx skills add Besty0728/Unity-Skills --skill unity-gameobject -g -y
自动化 Unity HybridCLR 热更新预构建流程，包括配置程序集、编译 DLL、生成 AOT 引用及对接 YooAsset。
配置热更程序集
编译热更 DLL
生成 AOTGenericReferences/link.xml
排查 HybridCLR 环境
把产物接进 YooAsset 打包链路
npx skills add Besty0728/Unity-Skills --skill unity-hybridclr -g -y
用于配置Unity项目中纹理、音频和模型等资产的导入设置，支持批量修改压缩、Sprite模式及平台覆盖参数。
调整资源导入方式
设置贴图压缩或 Sprite 模式
应用分平台覆盖
npx skills add Besty0728/Unity-Skills --skill unity-importer -g -y
提供Unity Inspector编辑器界面设计的最佳实践建议，包括字段序列化、属性装饰及UX优化，旨在提升脚本在Inspector中的可配置性和易用性。
设计组件在Inspector的呈现
组织序列化字段
添加提示/分组
npx skills add Besty0728/Unity-Skills --skill unity-inspector -g -y
提供Unity场景灯光的创建、配置、属性调整及批量管理功能，支持光照贴图与反射探针设置。
添加或调校灯光
布置场景照明
批量开关灯光
npx skills add Besty0728/Unity-Skills --skill unity-light -g -y
