Agent Skills
› Besty0728/Unity-Skills
Besty0728/Unity-Skills
GitHub提供Unity Addressables 1.22.3与2.9.1版本的设计规范，涵盖异步加载、热更新及迁移规则。辅助编写和审查资源管理代码，确保API使用正确性并避免过时调用。
安装全部 Skills
npx skills add Besty0728/Unity-Skills --all -g -y
集合内 Skills (84)
按质量分展示前 50 个（共 84 个），完整列表请用安装命令预览或逐个打开详情。
提供Unity Addressables 1.22.3与2.9.1版本的设计规范，涵盖异步加载、热更新及迁移规则。辅助编写和审查资源管理代码，确保API使用正确性并避免过时调用。
编写或审查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 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的持久化监听器，支持查询、添加、设置监听回调及触发事件，适用于UI按钮或逻辑触发器的绑定。
在Inspector里挂接UnityEvent
连接按钮或触发器回调
npx skills add Besty0728/Unity-Skills --skill unity-event -g -y
管理Unity项目的图形和画质设置，支持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编辑器中手动管理游戏对象组件的操作指南，包括添加、配置字段、排序及复制粘贴值。适用于单次或少量对象的Inspector界面操作，旨在替代自动化脚本处理简单任务。
向游戏对象添加单个组件
在检查器中调整组件参数
重排单个对象的组件顺序
复制组件数值到另一个对象
npx skills add Besty0728/Unity-Skills --skill unity-manual-component -g -y
提供Unity编辑器中手动创建GameObject、组织层级结构及调整变换的UI操作指南，适用于少量对象的单次编辑场景。
手动创建单个GameObject
在Hierarchy中父子化或重排序对象
通过Inspector或Scene视图移动、旋转、缩放对象
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编辑器中场景视图的手动操作指南，包括导航、保存、切换及多场景管理。适用于3步以内的简单交互，复杂自动化任务建议调用REST模块。
使用鼠标键盘在场景视图中导航
保存当前场景
在加载的场景间切换或管理加法工作流
指导用户如何对物体进行相机构图
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 NGO 2.x多人联机功能，涵盖预制体注册、生成逻辑及主机/服务器/客户端启动。提供源码级验证与版本兼容性检查，支持查询与创建操作，确保网络对象正确初始化和运行。
搭建多人联机
注册网络预制体
连接生成逻辑
启动 host/server/client
npx skills add Besty0728/Unity-Skills --skill unity-netcode -g -y
提供Unity场景、项目及脚本的只读分析能力，用于编辑前收集上下文、理解陌生项目或审查结构。包含场景健康检查、组件统计、依赖图生成等18个技能，辅助AI获取工程背景信息。
编辑前收集上下文
理解陌生场景或项目
在不改动的前提下审查结构
npx skills add Besty0728/Unity-Skills --skill unity-perception -g -y
提供PICO Unity SDK v3.4.0的设计规范与避坑指南，涵盖环境配置、渲染、交互及平台服务。旨在防止AI因知识滞后产生幻觉，辅助代码编写、审查及版本迁移。
编写或审查PICO Unity SDK代码
配置PICO XR项目或OpenXR插件
从SDK 2.x迁移至3.x版本
实现视频透视、空间锚点或MR功能
npx skills add Besty0728/Unity-Skills --skill unity-pico-design -g -y
用于检查 Unity PrimeTween 插件安装状态、查询配置及 API，并生成 Transform 或 Sequence 动画脚本。支持探索动画接口和自动化生成 C# 代码，适用于 Unity 开发中的动画逻辑构建与调试。
检查 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运行时性能快照读取能力，包括帧率、内存占用及纹理网格资源统计。仅支持只读查询，不涉及录制或控制操作，用于快速检查游戏运行状态。
查看运行时性能
抓取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架构设计规范，涵盖四层结构、核心工具及容器选型规则。基于源码与文档生成，含详细行号锚点，用于指导代码编写、审查及架构决策，防止过时知识干扰。
编写或审查QFramework架构代码
注册System/Model/Utility组件
处理Command/Query/Event机制
绑定BindableProperty数据
IOCContainer选型决策
npx skills add Besty0728/Unity-Skills --skill unity-qframework-design -g -y
提供 Unity API 连通性测试的示例技能，用于验证 REST 服务可达性和冒烟测试。包含创建、删除对象及设置位置旋转等基础操作，仅供开发调试使用，禁止用于生产环境。
测试 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）查询功能。支持多实例版本管理与Schema优先调用，辅助Agent快速定位并加载对应模块文档以执行操作。
浏览模块目录
查找某事由哪个模块处理
确认模式要求
npx skills add Besty0728/Unity-Skills --skill unity-skills-index -g -y
提供Unity场景对象的智能查询、自动排布与引用绑定功能，支持基于组件属性或空间位置的SQL式查询及布局变换。
按条件或邻近关系查询场景对象
自动排布场景对象
自动连线引用
npx skills add Besty0728/Unity-Skills --skill unity-smart -g -y
指导在Unity编辑器关闭时通过本地Shell使用实验性Unity CLI进行项目配置、冷启动及功能启用的操作指南，强调读取本地配置文件与版本兼容性检查。
需要执行Unity CLI命令
检查或解析Unity Skills绑定配置
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 编辑器，支持创建/修改脚本、场景、资产及批量编辑。新增 QFramework 双轨支持，实现纯反射零编译期依赖，并修复多语言文案与模式限制问题。
用户要求从对话中实际操作 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
提供批量工作流编排能力，支持一次性执行多个技能步骤、预览后提交批量编辑及长时异步任务轮询。通过单次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场景视图和Game相机的创建、变换、属性调整及截图等操作的技能集。
取景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）功能，支持创建、配置 Decal Projector 及启用渲染特性。涵盖查询与修改操作，确保在 URP 环境下正确管理贴花资源与状态。
在 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版本，提供诊断查询、脚本生成及Pro专属动画配置功能，确保编辑器时安全操作。
接入DOTween插件
校验安装状态或模块完整性
配置DOTweenAnimation组件
npx skills add Besty0728/Unity-Skills --skill unity-dotween -g -y
用于控制与观察Unity编辑器状态，支持读取场景变更、操控Play Mode、检查运行时对象状态及执行菜单命令。提供SemiAuto/FullAuto操作模式说明，并明确高危操作的权限限制与常见幻觉规避指南。
读取持久化场景或文件变更
操控Play Mode运行状态
检查游戏对象运行时状态
执行编辑器菜单项
npx skills add Besty0728/Unity-Skills --skill unity-editor -g -y
提供Unity场景中GameObject的创建、删除、变换调整及层级管理功能，支持批量操作与对象路由指引。
搭建或调整场景层级
新建或删除物体
修改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
提供Unity Inspector编辑器UX设计建议，指导组件序列化字段组织、属性装饰及验证规则，提升脚本可配置性与作者体验。
设计组件在Inspector的呈现
组织序列化字段
添加提示/分组
npx skills add Besty0728/Unity-Skills --skill unity-inspector -g -y
