القائمة
When QWEN.md // TODO: → docs/TODO.md tracking keeps failing, close the gap with a PreToolUse hook — same pattern as rendering_naming_guard for comment enforcement
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when working on 3D-specific rendering — deferred chain, G-buffer, clustered shading, Stratum GI, ReGIR, SVGF/A-SVGF, TAA, shadow techniques, depth/HZB, anything 3D-specific. ALWAYS load titan-rendering-core first; this skill assumes core conventions. Loads Titan-specific overrides for realtime-rendering. NOT for 2D rendering or editor panels.
Use when diagnosing a Titan renderer artifact — flicker, ghosting, fireflies, banding, light leaks, seams, boil, NaN/Inf, aliasing, smear/trails, dark voids, shadow artifacts, GI instability, denoiser/TAA issues. The frame-isolation-first debugging method: capture 60Hz, diff frames / A-B vs classical, consult literature, isolate via systematic-debugging, propose (and prove) a fix, record empirically. NOT for landing the production fix (hand to titan-rendering-3d-agent), 2D rendering, or editor panels.
Use when working in titan-rendering-frame-graph, titan-rendering-core, or titan-rendering-post-process-core — frame graph DAG, RenderTarget, DevicePool, PostProcessHook, CameraFrameData, HDR intermediate, tonemap, color management. Foundational layer shared between current 3D and future 2D rendering. Loads Titan-specific overrides for realtime-rendering. NOT for 3D-specific concerns (deferred chain, GI, shadows) — load titan-rendering-3d after this.
When a Titan bench tool using Renderer3d lacks on_resize → renderer.resize(), depth_prepass_view and HZB occlusion resources are never created — DepthPrepass, HzbBuild, and SceneCull passes silently skip, and taps produce no output
When adding a camera UBO shared between Rust and WGSL, verify field-by-field that the CPU layout matches the WGSL struct — especially packed vec4 fields where reordering silently breaks the shader
When building a depth prepass for reverse-Z HZB occlusion culling, use Greater compare (not Always) — the closest fragment must win so the HZB stores the nearest occluding surface, not the farthest
| name | todo-gate |
| description | When QWEN.md // TODO: → docs/TODO.md tracking keeps failing, close the gap with a PreToolUse hook — same pattern as rendering_naming_guard for comment enforcement |
// TODO: → docs/TODO.mdQWEN.md requires that every // TODO: in code also have an entry in
docs/TODO.md. When this rule is repeatedly violated, the fix is a
mechanical PreToolUse hook — the same pattern used by
rendering_naming_guard.py for the output gate.
// TODO: is the fast path: type inline, move ondocs/TODO.md is a separate file in a separate directory — frictionWrite a Python script in .qwen/local-scripts/ following the existing
guard convention:
Write or Edit to .rs/.wgsl files// TODO: lines from the diff against
old_stringdocs/TODO.md already
contains the file stem (e.g. vsm_mark) plus at least one
significant word from the TODO textold_string are
skipped (only newly-added TODOs trigger)When a QWEN.md rule has no mechanical enforcement and the user reports repeated violations. Write the hook, add tests, commit — the gap closes at the next Write/Edit.
C:\Dev\Titan\.qwen\local-scripts\todo_gate_guard.py — 11 tests,
test_todo_gate_guard.py. Qwen Code auto-discovers hooks in
.qwen/local-scripts/.
TODO: fix this): words < 4 chars or stopwords
(implement, should, would, need, needs, full, body) are stripped.
If no significant words remain, allow — too vague to check.