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)でも自由に読み込めます。
- 不要な public フィールドよりも、
[SerializeField] privateを優先してください。 - シンプルな命名で十分な場合は、属性を過剰に付けないでください。
デフォルトルール
- 作成時の意図を明確にするには、
[Header]、[Tooltip]、[Space]、[Range]、[Min]、[TextArea]を使用してください。 - 必須の同一オブジェクト上の依存関係には、
[RequireComponent]を使用してください。 - デザイナーが直接作成する設定/データアセットには、
[CreateAssetMenu]を使用してください。 OnValidateは、軽量なエディター時の検証と正規化にのみ使用してください。- ポリモーフィックなシリアライズデータが本当に必要な場合にのみ、
SerializeReferenceを使用してください。
Inspector の品質チェックリスト
- デフォルト値は安全ですか?
- 必須の参照は明確ですか?
- フィールドは役割ごとにグループ化されていますか?
- 調整可能な値には制約が設けられていますか?
- デバッグ専用フィールドは、作成用フィールドと分けられていますか?
- 他の人が Inspector だけでこのスクリプトを理解できますか?
出力形式
- フィールドの公開方針
- 推奨する属性
- 検証ルール
- 作成時の UX 改善
- 避けるべき過剰設計
コメント
Markdown 対応