Agent Skills
› Besty0728/Unity-Skills
Besty0728/Unity-Skills
GitHub提供Unity Addressables资源管理的设计规范，涵盖异步加载、热更新及版本迁移规则。用于指导代码编写与审查，确保使用正确的API和生命周期管理，避免过时用法。
安装全部 Skills
npx skills add Besty0728/Unity-Skills --all -g -y
集合内 Skills (85)
按质量分展示前 50 个（共 85 个），完整列表请用安装命令预览或逐个打开详情。
提供Unity Addressables资源管理的设计规范，涵盖异步加载、热更新及版本迁移规则。用于指导代码编写与审查，确保使用正确的API和生命周期管理，避免过时用法。
编写或审查Addressables代码
异步加载资源或场景
配置热更新或目录刷新
Addressables版本迁移
npx skills add Besty0728/Unity-Skills --skill unity-addressables-design -g -y
用于自动化管理Unity Addressables资源系统的技能，包括检查安装配置、创建资源组、添加资产条目、切换Profile及构建内容。通过反射调用Editor 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 Mecanim动画系统，包括创建控制器、配置状态机与参数、运行时驱动动画及分配控制器到游戏对象。
搭建或连接Animator
调整动画状态机
运行时驱动动画参数
npx skills add Besty0728/Unity-Skills --skill unity-animator -g -y
用于管理Unity Behavior模块，包括行为图资产发现、代理绑定及黑板变量读写。支持NPC/AI决策逻辑搭建，处理行为树与运行时报错防护。
搭建 NPC/AI 决策逻辑
使用行为树/行为图
读写黑板变量
npx skills add Besty0728/Unity-Skills --skill unity-behavior -g -y
为Unity小游戏提供轻量级架构蓝图，涵盖核心循环、场景模块及脚本清单。适用于从零开始搭建游戏原型或垂直切片，推荐最小可行结构而非庞大框架。
从零开始做小游戏
搭建某类型核心结构
组织特定玩法
npx skills add Besty0728/Unity-Skills --skill unity-blueprints -g -y
在Unity编辑器中检查和修改UnityEvent的持久化监听器，支持挂接按钮回调、查询及配置事件监听。
在Inspector里挂接UnityEvent
连接按钮或触发器回调
脚本化持久监听
npx skills add Besty0728/Unity-Skills --skill unity-event -g -y
用于管理Unity项目的图形与画质设置，包括查询/配置SRP资产、调整质量等级及着色器剥离等。支持Built-in、URP和HDRP渲染管线，提供半自动查询和全自动修改技能。
配置工程图形/画质设置
指定 SRP 资产
调整质量等级
npx skills add Besty0728/Unity-Skills --skill unity-graphics -g -y
管理Unity编辑器撤销/重做历史，支持查看当前状态、逐步撤销或重做操作，适用于审查改动和导航历史记录。
查看或浏览撤销历史
逐步撤销/重做
审查改动
npx skills add Besty0728/Unity-Skills --skill unity-history -g -y
提供Unity编辑器中手动添加、配置、排序及复制组件的GUI操作指南，适用于少量对象的单次Inspector工作流，复杂批量任务则建议自动化。
向游戏对象添加单个组件
在检查器中调整组件字段
重新排序对象上的组件
复制组件值到另一对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-component -g -y
提供Unity编辑器中手动创建、组织层级和调整变换的逐步操作指南，适用于少量对象的快速编辑场景。
手动创建单个GameObject
在Hierarchy中父子化或重排对象
通过Inspector或Scene视图移动、旋转或缩放对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-gameobject -g -y
提供Unity编辑器中材质手动创建、颜色修改、Shader切换及对象绑定的操作步骤指南，适用于少量材质的快速调整，批量任务则建议转向自动化模块。
创建新材质资产
更改材质颜色或Shader
将材质拖拽到MeshRenderer或Mesh上
npx skills add Besty0728/Unity-Skills --skill unity-manual-material -g -y
提供Unity编辑器场景视图的手动操作指南，涵盖视角导航、保存、切换及叠加加载等基础工作流。适用于无需REST自动化的简单场景管理任务。
通过鼠标和键盘在场景视图中导航
保存当前场景
在已加载场景或叠加场景工作流之间切换
指导用户如何调整相机以聚焦特定对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-scene -g -y
用于在Unity中编辑材质和着色器属性，支持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 NGO 2.x 多人联机开发的自动化技能，涵盖搭建网络、注册预制体、配置生成逻辑及启动主机/服务器/客户端等核心操作。
搭建多人联机
注册网络预制体
配置连接生成逻辑
启动 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 的设计规则与避坑指南，涵盖插件配置、MR 功能、交互及渲染。旨在防止因版本差异导致的代码幻觉，辅助正确编写和审查 XR/MR 应用代码。
编写或审查 PICO Unity SDK 代码
配置 PICO XR 项目或 OpenXR 路线
实现视频透视/空间锚点等功能
从旧版本迁移至新 SDK
npx skills add Besty0728/Unity-Skills --skill unity-pico-design -g -y
用于检查和生成 Unity PrimeTween 动画脚本的 Skill。支持查询安装状态、配置及 API，并生成 Transform/Sequence 动画代码，但生成操作因高风险被自动限制。
检查 PrimeTween 安装状态
探索支持的动画 API
生成 Transform/Sequence 动画代码
npx skills add Besty0728/Unity-Skills --skill unity-primetween -g -y
用于Unity ProBuilder插件的关卡灰盒搭建、几何体创建与编辑。支持参数化形状生成、批量处理及顶点面操作，提供严格的操作权限控制与防幻觉指引，适用于游戏场景快速原型设计。
搭建关卡灰盒
创建或编辑ProBuilder几何体
在编辑器内快速搭形
npx skills add Besty0728/Unity-Skills --skill unity-probuilder -g -y
提供Unity运行时性能快照的只读技能，用于抓取FPS、内存及渲染统计信息。支持查看帧率、批次、Draw Calls及各类型资源（纹理、网格）内存占用，辅助性能监控与排查。
检查运行时性能
抓取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
提供QFramework v1.0.257架构设计规范，涵盖Controller/System/Model/Utility四层职责、Command/Query/Event模式及容器选型规则。用于指导代码编写与审查，确保遵循官方源码最佳实践，避免过时用法。
编写或审查QFramework架构代码
注册System/Model/Utility组件
实现Command/Query/Event逻辑
使用BindableProperty绑定数据
在IOCContainer与IOCKit间进行技术选型
npx skills add Besty0728/Unity-Skills --skill unity-qframework-design -g -y
提供用于API连通性测试的示例技能，包括REST服务可达性检查、冒烟测试及基础GameObject操作（创建、删除、查询等），适用于开发调试与演示，非生产环境使用。
测试 REST 服务可达性
冒烟测试连通性
试发第一个调用
npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y
提供Unity Shader Graph的设计规范与审查指南，基于源码验证节点支持范围、SubGraph架构及URP/HDRP配方，确保建议符合2022.3与Unity 6版本特性。
构建或审查Shader Graph
组织节点链或SubGraph
布置黑板/关键字
npx skills add Besty0728/Unity-Skills --skill unity-shadergraph-design -g -y
指导用户在Unity项目中创建自定义Agent技能，包括C#代码编写、命名规范、文件存放位置及编译发现流程，确保技能被服务器正确识别和调用。
为项目编写自定义技能
扩展Agent在特定工程中的能力
npx skills add Besty0728/Unity-Skills --skill skill-creator -g -y
Unity技能模块索引，用于浏览目录、查找任务对应模块及确认执行模式要求。提供SA/FA/Mixed模式说明和API调用指引，辅助快速定位文档。
浏览模块目录
查找某事由哪个模块处理
确认模式要求
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编辑器关闭时通过本地Shell使用实验性Unity CLI，处理项目绑定配置校验、功能开关检查及版本兼容性，支持冷启动等自动化操作。
需要调用Unity CLI执行任务
检查Unity CLI绑定配置状态
npx skills add Besty0728/Unity-Skills --skill unity-cli -g -y
提供 Unity YAML 文件安全手动编辑指南，作为 REST API 无法触达时的最后手段。用于修复编译失败、断裂的 GUID/fileID 引用、.meta 文件或合并冲突等序列化问题。
REST 无法触达时手编 YAML
修复 m_Script GUID 或断裂 fileID 引用
修复 .meta 文件或合并冲突
npx skills add Besty0728/Unity-Skills --skill unity-yaml-editing -g -y
通过本地REST API自动化操作Unity编辑器，支持创建、修改GameObject、场景及资产等批量编辑与测试任务。
用户需要从对话中实际操作Unity编辑器
需要创建、修改或批量编辑游戏对象/脚本/场景/资源
运行编辑器自动化测试
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操作，支持资源导入、移动、删除、查找及元数据查询。提供批量处理优化，区分半自动与全自动模式，并严格管控高危写入操作。
整理项目资源文件
导入或移动外部文件到Unity工程
查询资源元数据或标签
脚本化执行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
提供批量操作和异步任务编排能力，通过单一HTTP调用顺序执行最多50个技能步骤。支持参数引用、预览模式及错误处理策略，旨在减少网络往返并优化Unity场景中的批量编辑与长时任务执行效率。
一次性操作大量对象
运行或轮询长时异步任务
先预览后提交的批量编辑
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 和 Game Camera 的控制能力，包括创建、调整变换、属性配置、截图及正交模式切换等。
取景 Scene View
创建或调整相机
修改 FOV 或裁剪面
npx skills add Besty0728/Unity-Skills --skill unity-camera -g -y
用于Unity中Cinemachine虚拟相机的创建、配置与调校，支持2.x和3.x版本。涵盖相机行为构建、跟随注视设置及噪声配置等运镜效果开发任务。
创建或调校Cinemachine相机
配置跟随/注视/噪声
构建运镜效果
npx skills add Besty0728/Unity-Skills --skill unity-cinemachine -g -y
用于清理和审计Unity项目的技能集合，支持查找未使用资产、重复文件、缺失引用及空文件夹，提供发布前瘦身与资源排查功能。
给项目瘦身
排查重复或孤立资源
发布前审计
npx skills add Besty0728/Unity-Skills --skill unity-cleaner -g -y
管理Unity游戏对象组件，支持挂载、移除、复制、开关及读写序列化字段。涵盖只读与自动写入操作模式，处理组件类型解析、属性命名映射及值编码规则，确保在安全模式下正确执行高风险删除或方法调用。
挂载或移除组件
在对象间复制组件
开关组件
读写序列化字段
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 动画库的设计规范，涵盖初始化、序列构建、生命周期管理及调试陷阱，基于源码提炼规则以指导代码编写与审查。
编写或审查 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、检查运行时状态及执行菜单项。包含操作模式说明、高危技能限制及常见错误规避指南。
读取持久化场景或文件变更
驱动Play Mode运行
检查游戏对象运行时状态
执行编辑器菜单命令
npx skills add Besty0728/Unity-Skills --skill unity-editor -g -y
提供Unity场景对象的创建、查找、删除、重命名及变换调整功能。支持批量操作，处理层级关系与坐标空间转换，确保对象标识符的优先级匹配与事务性回滚。
搭建或调整场景层级
新建或删除物体
修改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模式
应用分平台覆盖
npx skills add Besty0728/Unity-Skills --skill unity-importer -g -y
