메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | visualize-uitk-uxml |
| description | 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. |
Assets/UI/Screens/**/*.uxmlComplements unity-ui-toolkit.mdc (BEM + name hooks). This skill owns output format and research steps.
Deliver in this order unless the user asks for tree only:
+--, `--, | indent) or Unicode box-drawing in chat markdownname (primary) + short role in bracketstext="..." for Button / Label when static in UXML← Populate() / RailMenuFocus.CreateButton--hidden, display: none hosts| Phase | Input state | Visible branch | Owner presenter |
UIDocument)List each document, sortingOrder if known, and what is not in CommandRail.
Use only for multi-document or sequence flows (open Shop, Tab party menu). Follow plan-mode mermaid rules (no spaces in node IDs).
Task Progress:
- [ ] 1. Identify root UXML path(s) under Assets/UI/
- [ ] 2. Run uxml_tree.py (or Read UXML if script unavailable)
- [ ] 3. Grep C# for name hooks and presenters
- [ ] 4. Read USS for --hidden / context BEM modifiers
- [ ] 5. Emit tree + tables; link file paths
| Ask | Start here |
|---|---|
| Global left rail | Assets/UI/Screens/Shared/CommandRail.uxml |
| Hub overlay / shop picker | Assets/UI/Screens/Hub/HubHud.uxml |
| Party Tab shell | Assets/UI/Screens/Shared/PartyMenu.uxml |
| Exploration | C# map hosts (MapGridHostBuilder + MapView.uss), PartyFormationFloater.uxml, PartyMenu.uxml |
| Combat | Assets/UI/Screens/Combat/CombatHud.uxml |
| Empty rail template | Assets/UI/Screens/Shared/RailMenuVertical.uxml |
python .cursor/skills/visualize-uitk-uxml/scripts/uxml_tree.py Assets/UI/Screens/Shared/CommandRail.uxml
Multiple files:
python .cursor/skills/visualize-uitk-uxml/scripts/uxml_tree.py `
Assets/UI/Screens/Shared/CommandRail.uxml `
Assets/UI/Screens/Hub/HubHud.uxml `
Assets/UI/Screens/Shared/PartyMenu.uxml
Script prints name, class, text, Style src, Instance template. It does not expand UXML templates — note <ui:Instance> as template="...".
Grep patterns:
rg 'Q<.*>\("[^"]+"\)' Assets/Scripts/UI --glob "*.cs"
rg 'CommandRail\.|UIDocument|sortingOrder' Assets/Scripts/UI
rg 'CloneTree|VisualTreeAsset' Assets/Scripts/UI
For each name="foo" queried in code, annotate tree node foo ← HubHudView.
Presenter → document map (extend as needed):
| Presenter | UXML / mount |
|---|---|
CommandRailPresenter | CommandRail.uxml |
HubHudView | HubHud.uxml + clones pickers into hub-hud |
PartyMenuOverlayView | PartyMenu.uxml; section rail = CommandRail.PartySectionRailRoot |
ExplorationMapCoordinator | ExplorationMap GO — MinimapPanelPresenter + ExpandedMapOverlayPresenter |
CombatHudView | CombatHud.uxml + cloned pickers |
Read paired .uss for:
display: none + --hidden modifierscommand-rail--context-hub)transition-property on rail enter (see CommandRailEnterTransition)Annotate tree leaves with instant hide vs animated when relevant.
UIDocument; party backdrop and shop pickers are others unless user scopes one file.party-menu-nav on CommandRailPresenter.Populate() builders.Assets/UI/Screens/Shared/CommandRail.uxml.Full CommandRail walkthrough: examples.md.
.cursor/plans/ or issue contextaudit-uitk-uss-class-toggles — USS class usage, not hierarchyPick 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).
Audits Grid Dungeon UI presenters, facades, and phase HUD wiring against centralized-ui-services.md and ICentralizedUiSurface. Auto-enables caveman mode (full) for audit output. Use when auditing a component for centralized UI service compliance, migration readiness, CloneTree embed smells, facade lifecycle vocabulary, presentation bus shells/projectors, or before/after extracting a picker/overlay to GameState.