القائمة
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