菜单
When sub-agents keep straying outside the approved file list from the plan, close the gap with a PreToolUse hook that reads .qwen/task_scope.json — same pattern as rendering_naming_guard and todo_gate_guard
用 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 | scope-gate |
| description | When sub-agents keep straying outside the approved file list from the plan, close the gap with a PreToolUse hook that reads .qwen/task_scope.json — same pattern as rendering_naming_guard and todo_gate_guard |
| source | auto-skill |
| extracted_at | 2026-06-16T01:00:00.000Z |
QWEN.md: NEVER deviate from an agreed spec or plan without BOTH (1) verifying against code + spec, and (2) consulting the user. File-scope drift — touching files the plan didn't list — is the most common deviation vector.
Write a Python script in .qwen/local-scripts/ following the existing
guard convention:
Write or Edit to .rs/.wgsl files.qwen/task_scope.json for the approved file
list. Inert when the file doesn't exist./..rs/.wgsl are gated (same as
todo-gate){
"task": "Task 2: SceneCull shader + indirect draw buffer",
"files": [
"crates/titan-rendering-scene-cull/src/indirect.rs",
"crates/titan-rendering-scene-cull/src/shaders/scene_cull.wgsl",
"crates/titan-rendering-scene-cull/src/lib.rs"
]
}
Paths are relative to the project root. A trailing / approves all
files within that directory.
.qwen/task_scope.json with the approved files
before dispatching a taskWhen sub-agents or the main chain repeatedly add refactors, cleanups, or "improvements" beyond the task scope without explicit approval. Write the hook, add tests, commit — the gap closes at the next Write/Edit.
C:\Dev\Titan\.qwen\local-scripts\scope_guard.py — 8 tests,
test_scope_guard.py. Qwen Code auto-discovers hooks in
.qwen/local-scripts/.