菜单
When rendering/editor/streaming code changes lack documentation co-updates, enforce with a PreToolUse hook on git commit — checks staged diff for code vs doc coverage
用 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 | doc-gate |
| description | When rendering/editor/streaming code changes lack documentation co-updates, enforce with a PreToolUse hook on git commit — checks staged diff for code vs doc coverage |
| source | auto-skill |
| extracted_at | 2026-06-16T01:15:00.000Z |
QWEN.md requires that the LAST step of every plan, phase, and handoff updates the appropriate docs and skills with empirically verified findings. A plan is NOT complete until docs reflect what was learned.
When this rule is repeatedly violated, the fix is a PreToolUse hook on
git commit — same pattern as todo_gate_guard.py and
rendering_naming_guard.py.
Write a Python script in .qwen/local-scripts/:
Bash tool call containing git commitgit diff --staged --numstat and --name-only| Domain | Code patterns (prefix match) | Doc patterns (prefix match) |
|---|---|---|
| rendering | crates/titan-rendering, crates/titan-stratum-lighting | docs/rendering/, docs/design/, docs/agent-kb/, .qwen/skills/titan-rendering |
| editor | crates/titan-editor/ | docs/editor/, .qwen/skills/titan-editor/ |
| streaming | crates/titan-world | docs/editor/, .qwen/skills/titan-world-streaming/ |
Global doc files (count for all domains): docs/PLAN.md, docs/TODO.md,
docs/OPEN_BUGS.md, docs/POST_WORK_FINDINGS.md.
Use module-level _staged_files_fn and _staged_diff_stat_fn variables
that default to None — the real functions are called only when these are
None. Tests set them to lambda overrides. This avoids fragile monkey-patching
of module namespace entries.
When QWEN.md documentation-co-update rules have no mechanical enforcement and the user reports repeated violations. Write the hook, add tests, commit.
C:\Dev\Titan\.qwen\local-scripts\doc_gate_guard.py — 8 tests,
test_doc_gate_guard.py.
All four mechanical gates follow the same .qwen/local-scripts/*.py pattern,
auto-discovered by Qwen Code:
| Hook | Trigger | Rule |
|---|---|---|
rendering_naming_guard.py | Write/Edit | No proprietary names in code |
todo_gate_guard.py | Write/Edit | // TODO: must be in docs/TODO.md |
scope_guard.py | Write/Edit | No writes outside .qwen/task_scope.json |
doc_gate_guard.py | git commit | >50 lines code must co-update docs |
evaluate() / main() never raise; any error → allow.rs/.wgsl for code-level hooks;
Bash for commit-level hooks__file__ looking for .git_norm() → lowercase, backslash→slashpython -X utf8 test_*.py