关于 unity-inspector
用于改善 Unity 脚本在 Inspector 中配置与审阅体验的技能,涵盖序列化字段、特性、验证和编辑流程,并提醒避免不必要的装饰。
主要功能
- 01选择字段暴露方式
- 02用特性明确配置意图
- 03验证并规范化编辑器值
- 04提高引用与调节项的可见性
- 05避免不必要的 Inspector 装饰
适用场景
- 01整理组件的序列化字段
- 02明确必需引用
- 03准备面向设计师的配置资源
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ besty0728/ unity-skills --skill unity-inspector安装后在 Claude Code 中输入/unity-inspector确认已加载。
详细介绍
**调用此模块中的任何技能之前:**如果你准备根据技能名称或描述猜测参数后调用技能,请停下——先阅读此文件(或通过
GET /skills/recommend?includeSchema=true获取其架构)。如果你已从 recommend/schema 获取参数定义,则可直接执行 dryRun。
触发条件
- 设计组件在 Inspector 中的呈现方式
- 整理序列化字段
- 添加提示/分组
- 设计组件在 Inspector 中的呈现、组织序列化字段、添加提示/分组
Unity Inspector 设计
当脚本需要更易于在 Inspector 中编写、配置和审查时,使用此技能。
使用原则
模式:仅文档——无需限制 REST 技能;在任何运行模式(Approval / Auto / Bypass)下均可自由加载。
- 优先使用
[SerializeField] private,避免不必要的公共字段。 - 简单命名足以表达含义时,不要过度添加特性。
默认规则
- 使用
[Header]、[Tooltip]、[Space]、[Range]、[Min]、[TextArea],以明确编写意图。 - 对必需的同级依赖项使用
[RequireComponent]。 - 对设计人员应能直接创建的配置/数据资源使用
[CreateAssetMenu]。 - 仅将
OnValidate用于轻量的编辑器时验证和规范化。 - 仅在确实需要多态序列化数据时使用
SerializeReference。
Inspector 质量检查清单
- 默认值是否安全?
- 必需的引用是否一目了然?
- 字段是否按职责分组?
- 可调参数是否受到约束?
- 仅用于调试的字段是否与编写字段分开?
- 仅通过 Inspector,其他人能否理解此脚本?
输出格式
- 字段公开策略
- 推荐特性
- 验证规则
- 编写体验改进
- 应避免的过度设计
评论
支持 Markdown