version: "1.0.5" name: unity-inspector description: Advise on Unity Inspector authoring UX

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Designing component Inspector display
• Organizing serialized fields
• Adding tooltips/headers
• 设计组件在 Inspector 的呈现、组织序列化字段、添加提示/分组

Unity Inspector Design

Use this skill when scripts need to be easier to author, configure, and review in the Inspector.

Guardrails

Mode: Documentation only — no REST skills to gate; load freely under any operating mode (Approval / Auto / Bypass).

• Prefer [SerializeField] private over unnecessary public fields.
• Do not over-decorate with attributes when simple naming suffices.

Default Rules

• Use [Header], [Tooltip], [Space], [Range], [Min], [TextArea] when they clarify authoring intent.
• Use [RequireComponent] for mandatory sibling dependencies.
• Use [CreateAssetMenu] for config/data assets that designers should create directly.
• Use OnValidate only for lightweight editor-time validation and normalization.
• Use SerializeReference only when polymorphic serialized data is genuinely needed.

Inspector Quality Checklist

• Are defaults safe?
• Are required references obvious?
• Are fields grouped by responsibility?
• Are tuning values constrained?
• Are debug-only fields separated from authoring fields?
• Will another person understand this script from the Inspector alone?

Output Format

• Field exposure strategy
• Recommended attributes
• Validation rules
• Authoring UX improvements
• Over-design to avoid