Agent Skills
› Besty0728/Unity-Skills
Besty0728/Unity-Skills
GitHub辅助记录Unity架构决策(ADR)，通过对比方案、权衡利弊并固化理由，解决技术选型与架构设计问题。
Install All Skills
npx skills add Besty0728/Unity-Skills --all -g -y
Skills in Collection (76)
Showing top 50 of 76 by quality score. Use the install list command or open individual skills for the rest.
辅助记录Unity架构决策(ADR)，通过对比方案、权衡利弊并固化理由，解决技术选型与架构设计问题。
在多个技术方案间抉择
对比库或模式优劣
记录设计决策的来龙去脉
npx skills add Besty0728/Unity-Skills --skill unity-adr -g -y
管理Unity动画控制器，支持创建状态机、配置参数与过渡、分配控制器及运行时驱动。用于搭建Animator、调整状态逻辑或控制播放行为。
用户需要创建或编辑Unity Animator Controller
用户需设置或查询动画状态机参数（如bool/int/float/trigger）
用户希望在运行时控制动画播放或状态切换
npx skills add Besty0728/Unity-Skills --skill unity-animator -g -y
为Unity游戏提供架构建议，涵盖模块划分、解耦、SOLID原则及重构方向。指导代码结构规划与职责分离，避免过度设计，确保清晰的场景组织与通信规则。
规划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及定时器间做出合理选择，并规范资源清理与取消逻辑。
决定异步代码写法
协程与UniTask选型
处理资源清理与取消
npx skills add Besty0728/Unity-Skills --skill unity-async -g -y
提供Unity场景对象的批量查询、预览确认执行及异步任务调度能力，支持大量对象的一次性操作与长时任务轮询。
批量修改场景对象属性
一次性操作大量游戏物体
运行或轮询后台异步任务
npx skills add Besty0728/Unity-Skills --skill unity-batch -g -y
为Unity小游戏提供轻量级架构蓝图，涵盖平台、射击、塔防等类型。当用户从零开始搭建游戏核心结构或询问特定玩法组织方式时触发，输出最小可行方案而非复杂框架。
从零开始做小游戏
搭建某类型的核心结构
询问特定玩法怎么组织
npx skills add Besty0728/Unity-Skills --skill unity-blueprints -g -y
管理Unity场景视图书签，支持保存相机位置与选中对象、快速跳转至已存视角及列表管理删除。适用于开发中保存和恢复特定机位或场景导航场景。
保存当前场景视角
跳转到已保存的书签位置
列出所有书签
删除指定书签
npx skills add Besty0728/Unity-Skills --skill unity-bookmark -g -y
提供Unity场景视图与游戏相机的控制能力，包括移动旋转、创建配置、属性调整及截图。用于取景、相机管理及脚本化设置。
用户需要移动或旋转Unity Scene View视图
用户要求创建新的Game Camera或调整其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 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插件的配置、校验与组件管理，支持探测安装状态、设置调优及生成脚本，提升动画开发效率。
用户需要接入或配置DOTween插件
用户询问DOTween安装状态或模块信息
用户要求批量添加或调整DOTweenAnimation组件
npx skills add Besty0728/Unity-Skills --skill unity-dotween -g -y
控制并观察Unity编辑器，支持场景变更读取、Play模式管理、对象状态检查及撤销重做等操作。适用于AI恢复后同步编辑器状态或监控运行时变化的场景。
用户在AI离开期间修改了Unity项目
文件监控报告有变更需要确认
需要操控编辑器状态以进行调试或自动化测试
npx skills add Besty0728/Unity-Skills --skill unity-editor -g -y
用于在Unity编辑器中配置和管理UnityEvent持久化监听器，支持添加、移除、查询和触发事件回调。适用于Inspector界面绑定按钮或触发器逻辑，以及通过脚本自动化设置序列化事件。
用户需要在Inspector中为按钮或组件挂接事件回调
用户要求'事件绑定'或配置UnityEvent监听器
需要通过脚本批量管理或修改UnityEvent的持久化监听
npx skills add Besty0728/Unity-Skills --skill unity-event -g -y
提供Unity场景层级管理技能，支持游戏对象的创建、删除、变换调整（位置/旋转/缩放）、父子关系设置及批量操作。旨在简化场景搭建与物体操控流程，提升API调用效率。
用户需要创建或销毁游戏对象
用户要求移动、旋转或缩放物体
用户需调整物体层级结构或查找特定对象
npx skills add Besty0728/Unity-Skills --skill unity-gameobject -g -y
用于管理Unity工程级图形与画质设置，支持读取和编辑渲染管线资产、质量档位及着色器配置。适用于SRP资产分配、画质等级调整等场景。
配置工程图形/画质设置
指定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项目中纹理、音频和模型的资源导入设置，包括压缩格式、Sprite模式及分平台覆盖。支持批量操作与查询，需调用reimport刷新内存变更。
调整资源导入设置
设置贴图压缩或sprite模式
应用分平台导入覆盖
查询资源导入信息
npx skills add Besty0728/Unity-Skills --skill unity-importer -g -y
提供Unity Inspector编辑器体验优化建议，指导序列化字段组织、属性装饰及自定义显示设计。
Unity组件Inspector界面设计
序列化字段与属性配置优化
npx skills add Besty0728/Unity-Skills --skill unity-inspector -g -y
用于Unity引擎中灯光的创建、配置及批量管理。支持方向/点/聚/面光源设置，提供属性调整、开关控制、探针添加及烘焙查询功能，确保操作安全与准确。
用户要求添加或调校灯光
需要布置场景照明效果
批量启用或禁用多个灯光
询问或修改光照贴图设置
npx skills add Besty0728/Unity-Skills --skill unity-light -g -y
提供Unity材质与Shader属性编辑能力，支持Built-in/URP/HDRP管线。涵盖颜色、贴图、参数调整及批量操作，用于修改物体外观和材质设置。
调整Unity物体外观
修改材质参数或切换Shader
npx skills add Besty0728/Unity-Skills --skill unity-material -g -y
提供Unity Netcode for GameObjects 2.x的源码级设计规则，涵盖生命周期、所有权、RPC及网络变量等核心机制。用于编写、审查多人联机代码或排查同步问题。
编写多人联机代码
审查Netcode脚本
调试网络同步问题
用户提及'联机'或'多人同步'
npx skills add Besty0728/Unity-Skills --skill unity-netcode-design -g -y
用于配置和搭建 Unity NGO 2.x 多人联机功能，包括 NetworkManager、预制体注册及生命周期管理。支持查询状态与自动化配置，提供严格的运行模式控制和版本兼容性检查。
搭建多人联机游戏
配置 Netcode for GameObjects
启动主机/服务器/客户端
注册网络预制体
npx skills add Besty0728/Unity-Skills --skill unity-netcode -g -y
用于Unity项目资源与场景优化的技能集合，支持批量压缩纹理、网格和音频，分析场景面数、材质及过绘等性能瓶颈，旨在缩减包体大小并提升渲染效率。
用户要求优化工程资源或场景
需要批量压缩Texture/Mesh/Audio以减小包体体积
请求分析场景的面数、材质数量或使用情况
npx skills add Besty0728/Unity-Skills --skill unity-optimization -g -y
管理Unity Package Manager，支持包的安装、移除、刷新、搜索及版本检查。提供Cinemachine等快速配置，处理异步导入与域重载，防范幻觉调用，确保包操作安全高效。
用户要求安装或移除Unity包
查询已安装包列表或版本
搜索Unity注册表中的包
配置Cinemachine或Splines
npx skills add Besty0728/Unity-Skills --skill unity-package -g -y
为Unity游戏开发提供设计模式选择建议，涵盖ScriptableObject、状态机、对象池等。帮助用户根据具体场景判断是否适用特定模式，构建解耦系统，或在多种实现方案间进行权衡决策。
询问Unity中应使用何种设计模式
需要构建解耦的游戏系统
在事件总线、状态机或对象池等方案间做技术选型
npx skills add Besty0728/Unity-Skills --skill unity-patterns -g -y
提供Unity场景、项目及脚本的只读分析能力，用于收集编码上下文。涵盖结构解析、技术栈探测、健康检查及热点定位，支持编辑前审查或理解陌生项目，无需修改资产。
用户要求分析场景结构或项目整体情况
在代码编辑前需要获取项目上下文或进行健康检查
用户提到'分析一下场景'或'看看项目结构'
需要审计Unity项目结构而不进行任何修改
npx skills add Besty0728/Unity-Skills --skill unity-perception -g -y
提供Unity性能审查建议，诊断掉帧卡顿、减少内存分配及规划优化。涵盖Update循环、对象池、GC压力等红线问题，并揭示隐藏性能陷阱。
Unity性能审查
诊断掉帧或卡顿
减少内存分配
规划对象池或优化
npx skills add Besty0728/Unity-Skills --skill unity-performance -g -y
提供Unity编辑器期的物理查询与配置能力，支持射线检测、重叠检查、重力设置及物理材质管理。用于在编辑状态下同步执行物理计算和资产修改，辅助游戏开发中的碰撞与物理调试。
用户需要发射射线并获取命中信息
用户希望检测特定区域内的碰撞体重叠
用户需要查询或修改全局重力设置
用户要求调整物理层碰撞矩阵
用户提及'射线检测'或'物理设置'
npx skills add Besty0728/Unity-Skills --skill unity-physics -g -y
用于在Unity URP/HDRP中配置SRP后处理效果，支持添加、调校泛光、色调映射及调色等视觉参数。
配置现代SRP后处理
向VolumeProfile添加或调整效果
调整URP/HDRP场景观感
npx skills add Besty0728/Unity-Skills --skill unity-postprocess -g -y
管理Unity预制体，支持创建、实例化、应用覆盖、解包、查找实例及创建变体。提供批量实例化优化，区分读写模式，防止幻觉调用，辅助高效处理预制体资产与场景对象。
用户需要创建或编辑Prefab
在场景中实例化预制体
查找预制体的所有实例
应用或撤销预制体覆盖
创建预制体变体
npx skills add Besty0728/Unity-Skills --skill unity-prefab -g -y
提供PrimeTween动画库的设计规范，涵盖补间创建、序列管理、回调处理及生命周期控制。用于指导编写或审查Unity动画代码，诊断行为并避免常见陷阱。
编写PrimeTween动画代码
审查PrimeTween相关实现
诊断动画生命周期问题
npx skills add Besty0728/Unity-Skills --skill unity-primetween-design -g -y
用于检查Unity中PrimeTween插件安装状态、查询运行时配置及列出公开动画工厂方法，并生成生命周期感知的Transform或Sequence动画C#脚本。
检查PrimeTween安装状态
探索支持的动画API
生成Transform或Sequence动画代码
npx skills add Besty0728/Unity-Skills --skill unity-primetween -g -y
提供Unity ProBuilder网格建模能力，支持关卡灰盒搭建、几何体创建与编辑。涵盖形状生成、面/顶点操作及批量处理，适用于3D场景快速原型设计与关卡布局。
用户需要搭建关卡灰盒或白模
用户要求创建或编辑ProBuilder网格、面、顶点
用户在编辑器内进行3D形状快速原型设计
npx skills add Besty0728/Unity-Skills --skill unity-probuilder -g -y
提供只读的Unity运行时性能快照，支持获取帧率、内存及各类资源占用统计，用于性能监控与排查。
查看运行时性能
抓取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
提供Unity项目元数据查询能力，包括版本、渲染管线、Shader列表、UPM包、构建设置及Layer/Tag管理。支持只读信息查询及异步构建玩家操作，用于项目状态检查与配置获取。
查看Unity版本或渲染管线
列出已安装的Shader或UPM包
获取构建设置或Layer/Tag信息
执行游戏构建(出包)
用户询问'项目信息'或'什么版本'
npx skills add Besty0728/Unity-Skills --skill unity-project -g -y
提供Unity REST API连通性测试的示例技能，用于验证服务可达性和冒烟测试。包含创建、删除、查询游戏对象及设置属性等基础功能，适用于调试和演示场景。
测试连接
通不通
API连通性测试
验证REST服务响应
冒烟测试
npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y
为Unity场景装配提供契约建议，明确必备对象、组件依赖及启动逻辑。用于界定场景内容、规划引用连线或记录依赖，避免运行时隐式查找，提升架构清晰度。
用户询问场景必须包含哪些对象
需要规划Bootstrap或组件引用连线
定义场景组件依赖关系
文档化场景装配规则
npx skills add Besty0728/Unity-Skills --skill unity-scene-contracts -g -y
管理Unity场景生命周期，支持创建、加载（含叠加）、保存、卸载、切换及查询信息。提供截图与对象搜索功能，明确区分半自动与全自动执行模式，并规避常见幻觉调用。
打开或保存场景
切换活动场景
查询场景内容或层级
叠加加载场景
npx skills add Besty0728/Unity-Skills --skill unity-scene -g -y
为Unity脚本职责划分提供建议，指导用户决定类应作为MonoBehaviour、ScriptableObject、纯C#服务还是installer。适用于确定类职责、拆分责任或选择合适角色场景。
决定类的职责
在类型间拆分职责
选择MonoBehaviour与纯C#间的角色
npx skills add Besty0728/Unity-Skills --skill unity-script-roles -g -y
提供Unity C#脚本的创建、读取、修改、搜索及编译检查等全生命周期管理功能，支持批量操作与高危操作拦截，辅助开发者高效编写和维护C#代码。
用户要求编写或编辑C#代码
需要跨脚本搜索或重构文件布局
检查Unity编译错误
npx skills add Besty0728/Unity-Skills --skill unity-script -g -y
用于在Unity中管理ScriptableObject资产，支持创建、读取、修改、删除、复制及查找等操作。涵盖数据资产的CRUD及批量设置，适用于配置表管理和SO实例脚本化维护。
创建或编辑ScriptableObject数据资产
查找或列出SO实例
配置表管理
SO资产脚本化管理
npx skills add Besty0728/Unity-Skills --skill unity-scriptableobject -g -y
提供Unity游戏脚本的设计审查与重构建议，涵盖代码质量、解耦、可维护性及数据生命周期管理。适用于代码审查、优化高耦合脚本及规划重构以提升系统稳定性。
审查代码质量
理顺高耦合脚本
规划重构提升可维护性
评估Unity脚本设计
npx skills add Besty0728/Unity-Skills --skill unity-scriptdesign -g -y
