菜单
One-stop quick reference for Valkur conventions — assemblies, layers, sorting, code style, the cardinal "console must be clean" rule, key gotchas. Load this skill at the start of any non-trivial task to keep the rules close to hand.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Performance diagnosis + optimization for Valkur — Profiler/Recorder API workflow, three-axis bottleneck model (CPU main / CPU render / GPU), URP HDR/shadow/post-process tuning, UGUI canvas pipeline, GC reduction patterns (hoisted buffers, no per-frame allocations), tick-rate throttling, and the catalog of optimizations already applied. Load whenever chasing low FPS, frame-time spikes, GC pauses, or memory pressure.
Performance diagnosis and optimization for the Valkur Unity project. Use when chasing low FPS, frame-time spikes, GC pauses, expensive Updates, GPU bottlenecks, render-thread stalls, or memory pressure. Covers Profiler/Recorder API workflow, hot-path patterns, URP/UGUI specifics, GC reduction, and Valkur's catalog of previously-applied optimizations.
Manage the Valkur Unity asset import pipeline — sprite import policies, atlas building, PPU configuration, pivot normalization, audio import. Covers ValkurAssetPostprocessor, CharacterAtlasBuilder, TileAtlasBuilder, TilePaletteBuilder.
Valkur Unity asset import pipeline — sprite import policies, atlas grouping, ValkurAssetPostprocessor, CharacterAtlasBuilder, TileAtlasBuilder, audio import. Load when importing, organizing, or validating assets.
General Unity development for the Valkur project. Use when writing or refactoring Unity C# scripts, designing systems, working with MCP for Unity tools, debugging runtime issues, configuring assemblies/layers/ScriptableObjects, or troubleshooting domain-reload, Cinemachine, URP 2D, Tilemap, UI Toolkit/uGUI, or input issues. Covers MCP workflow, console verification, performance patterns, hot-reload safety, and project conventions.
Markdown documentation conventions for Valkur — markdownlint config, MD028 (no blank lines inside blockquotes), MD029 disabled globally for ordered lists, frontmatter style, table layout. Load when creating or editing any `.md` file (roadmaps, audits, checklists, migration guides) so lint warnings stay at zero.
| name | valkur-conventions |
| description | One-stop quick reference for Valkur conventions — assemblies, layers, sorting, code style, the cardinal "console must be clean" rule, key gotchas. Load this skill at the start of any non-trivial task to keep the rules close to hand. |
The longer form lives in CLAUDE.md and .github/skills/unity-development/SKILL.md. This is the fast-lookup card.
mcp_unity_refresh_unity (compile=request, mode=force, scope=scripts, wait_for_ready=true) then mcp_unity_read_console (types=["error","warning"], format=detailed) after every C# change. Also check the terminal log if Unity batch / test runner just ran.unity/Udemy_Inspiration/.Grep first)..asset files; world state lives in StreamingAssets/ written by runtime editors via the IRepository pattern.| Path | Assembly | May reference |
|---|---|---|
Scripts/Core/ | Valkur.Core | — |
Scripts/Data/ | Valkur.Data | Core |
Scripts/Infrastructure/ | Valkur.Infrastructure | Core, Data |
Scripts/Gameplay/ | Valkur.Gameplay | Core, Data, Infrastructure |
Scripts/UI/ | Valkur.UI | Core, Data, Infrastructure |
Scripts/Editor/ | Valkur.Editor | All above |
Forbidden: Valkur.Gameplay → Valkur.UI (would create a cycle). Use ServiceLocator or GameEvents for cross-system signaling.
[SerializeField] private + [Tooltip("…")]. Never public fields.ServiceLocator.Get<T>(). Never raw singletons. SingletonMonoBehaviour<T> only for true scene-wide managers.[RuntimeInitializeOnLoadMethod(SubsystemRegistration)] reset for any static mutable state (Domain Reload is OFF)._camelCase private fields, PascalCase properties/methods. One class per file.Physics: Player(8), NPC(9), Projectile(10), World(11), Pickup(12), UIBlocker(13), Building(14), Spawner(15).
Sorting (depth): Background → Ground → FloorDecals → ObjectsLow → WallsBottom → Entities → Decorations → WallsTop → ObjectsHigh → Projectiles → VFX → Overhead → UI_World → Overlay.
| Concept | Value | Notes |
|---|---|---|
| World PPU (most assets) | 16 | 1 world unit = 16 px |
| Buildings PPU | 32 | Higher PPU for finer detail |
| Tiles PPU | 32 | Audited via tools/atlas/audit_tile_sizes.py |
| Tick rate | 60 Hz | Used by MusicBeatClock, status-effect ticks |
| Bug | Cause | Fix |
|---|---|---|
MissingReferenceException after second Play | Static field holds destroyed Object | [RuntimeInitializeOnLoadMethod(SubsystemRegistration)] reset |
| Camera doesn't pan | Cinemachine Follow overrides every LateUpdate | CameraSetup.DetachFollow() |
| Player attacks while editor open | Missing input guard | if (GameEditorManager.AnyEditorActive) return; |
InventorySlot == null won't compile | Struct, not class | .IsEmpty |
SpellDefinition.cooldown doesn't exist | Renamed | cooldownDuration |
Health.Current doesn't exist | Renamed | CurrentHp |
DashAbility not in Player namespace | Lives in Valkur.Gameplay.Combat | Update using |
| Zone lookup fails on case mismatch | OrdinalIgnoreCase | Pass consistent casing anyway |
| Custom GL drawing invisible in URP | Camera.current null in URP | RenderPipelineManager.endCameraRendering |
| TMP NullRef on Buttons | Image + TMP_Text on same GO | Split into parent + child |
| EditMode "leaked materials" | .material clones on use | Use .sharedMaterial or LogAssert.ignoreFailingMessages = true |
| Black tiles | Sprite-Lit-Default × no Light2D = ×0 | Sprite-Unlit-Default fallback |
mcp_unity_refresh_unity(compile="request", mode="force", scope="scripts", wait_for_ready=true)mcp_unity_read_console(types=["error","warning"], page_size=50, format="detailed", include_stacktrace=true)