Agent Skills
› Besty0728/Unity-Skills
Besty0728/Unity-Skills
GitHub辅助记录Unity架构决策(ADR)，通过对比选项、权衡优缺点并固化理由，帮助用户在技术选型或方案抉择时做出决策。适用于多方案对比及记录设计决策背景。
安装全部 Skills
npx skills add Besty0728/Unity-Skills --all -g -y
集合内 Skills (76)
按质量分展示前 50 个（共 76 个），完整列表请用安装命令预览或逐个打开详情。
辅助记录Unity架构决策(ADR)，通过对比选项、权衡优缺点并固化理由，帮助用户在技术选型或方案抉择时做出决策。适用于多方案对比及记录设计决策背景。
用户询问技术方案选型（如选哪个）
需要对比不同库或设计模式
记录架构决策的来龙去脉与理由
npx skills add Besty0728/Unity-Skills --skill unity-adr -g -y
用于编辑Unity Animator控制器及控制运行时参数。支持创建控制器、管理状态机（状态/过渡/层）、添加和设置各类参数(float/int/bool/trigger)，以及分配控制器和播放动画状态。
搭建或连接Animator
调整动画状态机
在运行时驱动动画参数
用户提及'动画'或'状态机'
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资源数据库，支持导入、删除、移动、复制、查找及元数据查询。提供批量操作优化，区分读写权限与审批模式，避免幻觉调用错误API，引导至专用模块处理材质或脚本创建。
整理工程资源
导入或移动文件
查询资源元数据
用户提及'资源'或'资产'
npx skills add Besty0728/Unity-Skills --skill unity-asset -g -y
为Unity异步编程与生命周期管理提供策略建议。指导用户在Update、协程、UniTask及定时器间进行合理选择，强调事件驱动优先、明确生命周期所有权及资源清理，避免滥用Update和过度依赖UniTask，确保代码简洁且易于维护。
询问Unity异步代码写法
纠结使用协程还是UniTask
需要调度定时器或处理取消清理
讨论Unity生命周期管理
npx skills add Besty0728/Unity-Skills --skill unity-async -g -y
提供Unity批量操作与异步任务编排能力，涵盖对象/组件查询、预览确认执行、后台任务调度及轮询。适用于一次性处理大量对象或长时异步任务，确保批量编辑安全可控。
用户要求批量修改场景对象属性
需要查询或过滤大量GameObject
执行先预览后提交的批量变更
运行或监控后台异步任务进度
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场景视图与游戏相机，支持移动旋转、创建配置、设置FOV及截图。明确区分Scene View与Game Camera操作，纠正常见幻觉如不存在的camera_move命令，指导Cinemachine路由及不同截图模式选择。
用户需要调整或取景Scene View视角
用户要求创建、删除或修改Game Camera属性（如FOV、裁剪面）
用户提及镜头控制、相机设置或相关英文术语
npx skills add Besty0728/Unity-Skills --skill unity-camera -g -y
用于配置Unity Cinemachine虚拟相机（VCam/FreeLook等）及Body/Aim/Noise管线。支持创建、调校跟随/注视/噪声及运镜效果，兼容CM2.x/3.x并通过反射适配API差异。
创建或调校Cinemachine相机
设置跟随/注视或噪声参数
构建 cinematic 运镜效果
用户提及'虚拟相机'或'运镜'
npx skills add Besty0728/Unity-Skills --skill unity-cinemachine -g -y
用于清理和审计Unity工程，查找未使用资源、重复项、丢失引用及空文件夹。支持项目瘦身、发布前审计，通过两步确认机制安全删除资产，并具备严格的模式权限控制以防止误操作。
用户要求清理Unity项目或说'清理项目'
用户希望给项目瘦身或减少体积
排查重复或孤立的资源文件
发布前进行项目审计
npx skills add Besty0728/Unity-Skills --skill unity-cleaner -g -y
管理Unity GameObject组件，支持添加、移除、列出、复制、启用/禁用及读写字段。适用于挂载或移除组件、对象间复制、开关组件及序列化属性操作。提供单对象与批量执行技能，注意区分半自动与全自动模式。
用户要求添加、移除或列出GameObject组件
需要复制组件或修改其属性值
用户提及“加个组件”或“改组件属性”
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 包缺失情况。
在 URP 中添加贴花
配置 Decal Projector
启用或检查 Decal Renderer Feature
用户提及“贴花”或“decal”
npx skills add Besty0728/Unity-Skills --skill unity-decal -g -y
用于在Unity编辑器中自动化DOTween Free/Pro的配置、诊断与模块发现。支持校验安装状态、读取/配置DOTweenSettings、列出模块及快捷方式，并提供DOTweenAnimation组件的添加与调校功能，协助开发者快速集成和验证动画插件。
用户需要在项目中接入或配置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
连接按钮或触发器的回调函数
用户提到'事件绑定'或'按钮点击'
查询或修改组件上的序列化事件监听器
npx skills add Besty0728/Unity-Skills --skill unity-event -g -y
用于在Unity中创建、删除、移动、旋转、缩放GameObject，管理父子关系及批量操作。支持通过名称或ID查找和获取信息。注意避免幻觉调用不存在的API，组件和材质操作需路由至对应模块。
搭建或调整场景层级结构
新建或删除游戏物体
修改物体的Transform属性（位置、旋转、缩放）
对多个物体进行批量编辑
npx skills add Besty0728/Unity-Skills --skill unity-gameobject -g -y
管理Unity工程级图形与画质设置，支持SRP资产、质量档位及着色器配置。涵盖读取概览、切换质量等级、指定渲染管线及修改着色器剥离等能力，适用于画质调优与管线配置场景。
用户请求配置或调整项目画质设置
用户需要指定或更改SRP渲染管线资产
用户询问或调整质量等级(Quality Levels)
用户提到'画质设置'或'渲染管线配置'
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模式、压缩及分平台覆盖。提供批量设置与查询功能，强调批处理优先，并在修改后建议重新导入以生效。
调整资源导入方式
设置贴图压缩或Sprite模式
应用分平台导入覆盖
用户提及'导入设置'或'贴图压缩'
npx skills add Besty0728/Unity-Skills --skill unity-importer -g -y
提供Unity Inspector组件设计建议，涵盖序列化字段规范、UI属性组织及校验逻辑。指导如何优化编辑体验，提升脚本可读性与配置效率，适用于字段展示与界面布局设计场景。
设计组件在Inspector中的呈现方式
优化序列化字段的显示与分组
添加Tooltip或Header等提示信息
改善Unity编辑器内的作者体验
npx skills add Besty0728/Unity-Skills --skill unity-inspector -g -y
用于在Unity中创建、配置和批量管理灯光（Directional/Point/Spot/Area）。支持设置属性、开关状态及添加探针。提供防幻觉指引，明确区分单灯与批量操作技能，确保正确调用API进行场景照明布置。
用户要求添加或调校灯光
用户需要布置场景照明
用户提及批量启用或禁用灯光
用户说“加个灯”或“打光”
npx skills add Besty0728/Unity-Skills --skill unity-light -g -y
用于编辑Unity材质和Shader属性，支持Built-in/URP/HDRP管线。涵盖颜色、贴图、参数调整及批量操作。提供详细防幻觉指南，明确API命名规范与路径处理逻辑，确保准确修改物体外观。
用户要求调整物体外观或材质颜色
需要切换或修改Shader属性
批量设置多个物体的材质参数
npx skills add Besty0728/Unity-Skills --skill unity-material -g -y
为 Unity Netcode for GameObjects 2.x 提供源码级设计规则。涵盖生命周期、所有权、RPC、网络变量及场景管理等核心机制，辅助编写、审查多人联机代码或排查同步问题。
编写或审查多人联机代码
设计服务器/分布式权威逻辑
配置 RPC 或 NetworkVariable
排查 Netcode 同步问题
用户提及“联机”或“多人同步”
npx skills add Besty0728/Unity-Skills --skill unity-netcode-design -g -y
用于配置和自动化Unity NGO 2.x多人联机功能，涵盖NetworkManager、预制体注册及生命周期管理。支持查询与创建操作，严格限制删除、脚本生成及运行模式切换等高风险操作，需确保包已安装且版本兼容。
搭建多人联机
注册网络预制体
连接生成逻辑
启动host/server/client
用户提及'联机'或'多人游戏'
npx skills add Besty0728/Unity-Skills --skill unity-netcode -g -y
用于Unity项目资源优化，支持批量压缩纹理、网格和音频，分析场景面数与材质用量。涵盖只读分析与需授权的写型操作，旨在缩减包体体积及提升性能。
用户要求缩减包体大小
需要批量压缩纹理、模型或音频资源
用户表示'优化资源'或'包体太大'
需要分析场景面数和材质使用量
npx skills add Besty0728/Unity-Skills --skill unity-optimization -g -y
管理Unity包管理器(UPM)，支持安装、移除、刷新、搜索及检查已安装包。提供Cinemachine和Splines的快速配置流程。包含防幻觉指南，明确区分缓存查询与注册表搜索，并处理异步导入导致的服务器暂时不可用情况。
用户要求添加或移除UPM包
用户询问已安装的包版本
用户需要搜索或列出包
用户提及'装个包'或'UPM'
npx skills add Besty0728/Unity-Skills --skill unity-package -g -y
为Unity开发提供设计模式选型建议，涵盖ScriptableObject、事件系统、状态机、对象池等。指导用户根据解耦需求、性能开销及维护成本，在多种实现方案间进行对比分析，推荐最合适的1-3种模式以构建清晰架构。
询问Unity中适合的设计模式
判断是否应使用状态机或事件系统
需要构建解耦的系统架构
在对象池与常规实例化间做抉择
npx skills add Besty0728/Unity-Skills --skill unity-patterns -g -y
提供Unity场景、项目及脚本的只读分析能力，用于AI编码前的上下文收集。支持结构分析、技术栈探测、健康检查及热点定位。涵盖17个半自动只读Skill和1个需审批的导出报告Skill，帮助用户在不修改资产的前提下审查项目状态。
用户要求分析场景结构或项目概况
用户希望了解陌生场景或项目的技术栈
用户需要在编辑代码前进行上下文收集和审计
用户请求执行场景健康检查或性能优化建议
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 的 VolumeProfile 上配置现代 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 1.4.6源码级设计规则，涵盖工厂补间、序列管理、回调处理、生命周期控制及异步支持。用于编写或审查动画代码时规避DOTween习惯陷阱，优化性能并正确处理对象销毁。
编写PrimeTween动画代码
审查Tween或Sequence相关实现
诊断动画生命周期行为
处理目标对象销毁逻辑
配置PrimeTween全局参数
npx skills add Besty0728/Unity-Skills --skill unity-primetween-design -g -y
用于检查PrimeTween Free安装状态、查询运行时配置及公开动画工厂方法，并生成生命周期感知的Transform或Sequence动画C#脚本。
检查 PrimeTween 安装状态
探索支持的动画 API
生成 Transform 动画代码
生成 Sequence 动画代码
npx skills add Besty0728/Unity-Skills --skill unity-primetween -g -y
用于Unity ProBuilder模块的可编辑网格建模，支持关卡灰盒搭建、几何体创建与编辑。涵盖形状生成、面/边操作及批处理功能，需安装ProBuilder包，提供严格的操作模式与防幻觉指引。
关卡灰盒搭建
白模快速原型设计
ProBuilder几何体创建与编辑
编辑器内块状建模
npx skills add Besty0728/Unity-Skills --skill unity-probuilder -g -y
提供Unity运行时性能只读快照功能，涵盖帧率、内存及各类资源占用统计。支持获取整体性能数据、详细内存分布（纹理/网格/材质/音频）及Top N对象分析，用于性能监控与诊断，不修改任何状态。
查看运行时性能
抓取Profiler快照
检查内存或帧率统计
用户询问'性能数据'或'看看帧率'
分析特定资源类型（如纹理、Mesh）的内存占用
npx skills add Besty0728/Unity-Skills --skill unity-profiler -g -y
用于在提出架构改动前侦查现有Unity项目，检查版本、包、asmdef、目录及编码风格。适用于初次接触陌生项目、审计配置或用户询问项目情况时，确保建议与现有模式兼容。
初次接触陌生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
用于API连通性测试的示例技能，提供基础的Unity REST服务探测与简单对象操作。适用于冒烟测试、验证服务可达性及首次调用尝试，严禁用于生产环境。
测试连接
通不通
验证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场景，支持创建、加载（含叠加）、保存、卸载、切换及查询。处理打开/保存场景、切场景等需求。注意高危操作需Bypass权限，避免幻觉调用不存在的API。
用户要求打开或加载场景
用户要求切换活动场景
用户要求保存当前场景
用户要求获取场景信息或层级结构
npx skills add Besty0728/Unity-Skills --skill unity-scene -g -y
为Unity脚本职责划分提供建议，指导类应作为MonoBehaviour、ScriptableObject、纯C#服务还是installer。适用于确定类职责、拆分责任或选择架构模式时，防止过度使用MonoBehaviour。
用户询问某个类是否该用MonoBehaviour
用户需要决定类的职责分配
用户要在类型间拆分职责
用户在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资产，支持创建、读取、修改、删除、复制及查找。涵盖数据资产的脚本化管理与配置表操作，区分读写权限模式，并纠正常见幻觉调用错误。
创建或编辑ScriptableObject数据资产
查找SO实例
脚本化管理SO
用户提及'配置表'或'SO资产'
npx skills add Besty0728/Unity-Skills --skill unity-scriptableobject -g -y
提供Unity游戏脚本质量审查建议，涵盖代码重构、降低耦合及提升可维护性。适用于代码审查、梳理高耦合脚本或规划重构场景。
审查代码质量
理顺高耦合脚本
规划重构以提升可维护性
用户表示'看看我代码'或'代码有点乱'
npx skills add Besty0728/Unity-Skills --skill unity-scriptdesign -g -y
