메뉴
Validates Unity .meta GUID format (32 lowercase hex), uniqueness, and asset pairing under Assets/. Use when creating or editing .meta files, after adding Unity assets from the agent, before commit, or when diagnosing missing script types (CS0246).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Pick C# type suffix and assembly before creating or renaming classes. Read class-naming-patterns.md via review-config.json. Use when adding new C# types, choosing View vs Presenter vs Coordinator, splitting god classes, or renaming type suffixes in griddungeon-game.
Writes Grid Dungeon GitHub/PR test plans with consistent structure (automated Edit Mode paths, DevBootstrap manual tables, sign-off, N/A deferrals). Use when creating or updating test plans for issues, PRs, handoff, or ticket close-out.
Creates or refreshes UITK design-mirror assets under Assets/UI/Editor/DesignMirror/ from production shells + placeholder fixtures. Use when the user asks to create a mock/mirror, bootstrap design mirror, add a new mirrored component, or regenerate placeholder UXML/USS for UX visual editing.
Promotes UITK design-mirror layout and USS from Assets/UI/Editor/DesignMirror/ into production bindable shells under Assets/UI/Screens/. Use when the user asks to sync design mirror, promote mirror to production, or apply UX UITK changes.
Selects the next highest-priority open item from a GitHub Project backlog (Ready then Backlog, P0→P1→P2), claims it, and starts implementation. Use when the user asks to pull the next ticket, pick up backlog work, start the top priority issue, or work from a GitHub Project board (e.g. users/OWNER/projects/N).
Builds ASCII UI trees, phase visibility tables, and cross-UIDocument maps for Unity UI Toolkit UXML. Use when the user asks to visualize, diagram, or explain a UXML hierarchy (e.g. CommandRail, HubHud, PartyMenu), trace name hooks to C#, or compare rail vs overlay documents.
| name | validate-unity-meta |
| description | Validates Unity .meta GUID format (32 lowercase hex), uniqueness, and asset pairing under Assets/. Use when creating or editing .meta files, after adding Unity assets from the agent, before commit, or when diagnosing missing script types (CS0246). |
Assets/**/*.metaCS0246 / missing MonoBehaviour after agent added a scriptAssets/ files or .meta changesDo not hand-author .meta files. Add the asset; let Unity Editor generate .meta.
Only write .meta when unavoidable (document why in the PR). Never guess GUIDs.
Task Progress:
- [ ] 1. Create/edit asset under Assets/ (prefer no .meta in diff)
- [ ] 2. Unity import (user) OR validate existing .meta if agent touched them
- [ ] 3. Run validate_unity_meta.py
- [ ] 4. Fix [FAIL] before commit
Full Assets/ scan:
python .cursor/skills/validate-unity-meta/scripts/validate_unity_meta.py
Changed paths only:
python .cursor/skills/validate-unity-meta/scripts/validate_unity_meta.py Assets/Scripts/UI/Views/MyView.cs.meta
python .cursor/skills/validate-unity-meta/scripts/validate_unity_meta.py Assets/UI/Screens/Exploration
Strict (missing .meta warnings fail too — use after Unity import):
python .cursor/skills/validate-unity-meta/scripts/validate_unity_meta.py --strict-warnings
GUID + duplicates only (no pairing):
python .cursor/skills/validate-unity-meta/scripts/validate_unity_meta.py --no-pairing path/to/file.meta
| Prefix | Meaning |
|---|---|
[ok] | All checked meta files valid |
[FAIL] | Block commit — fix GUID length/format, duplicates, orphan .meta |
[warn] | Missing .meta — normal until Unity imports; re-run after refresh |
| Failure | Fix |
|---|---|
guid length 33 | Delete .meta; let Unity regenerate, or correct to 32 chars |
must be 32 lowercase hex | Remove invalid characters; use a-f0-9 only |
duplicate guid | Delete one .meta; Unity regenerates a new GUID |
orphan (no asset) | Delete stray .meta or restore missing asset |
missing .meta | Open project in Unity; do not invent meta in agent |
Follow .cursor/rules/unity-meta-files.mdc whenever touching Assets/**.
unity-common-pitfalls.mdc