菜单
Run autonomous visual checks for Rust4D rendering changes. Use after touching WGSL shaders, RenderUniforms, camera projection, slice pipeline, primitives, or examples that affect rendering.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build or modify Rust4D primitives and tetrahedral meshes. Use when touching rust4d_math::Mesh4D, primitives, Tesseract4D, ShapeTemplate geometry variants, or any code that creates 4D tetrahedra for slicing.
Final quality gate for Rust4D feature branches. Use before PRs, releases, or after broad engine changes. Covers formatting, tests, clippy, rustdoc, visual captures, docs, and scratchpad handoff.
Rust4D math, matrix, rotation, and GPU layout conventions. Use when editing rust4d_math, Camera4D, WGSL shaders, projection matrices, GPU uniform structs, or anything passing matrices between Rust and the GPU. Prevents convention-mismatch bugs (row/column major, depth range, rotation planes, struct layout).
Verify the slice-plane invariant when changing Rust4D camera, movement, physics, or rendering code. Use before and after touching Camera4D, CharacterController4D, SimulationSystem, the slice shader, projection, or movement input handling. Explains the invariant, why it breaks, the regression tests, and the headless visual verification workflow.
| name | headless-visual-verification |
| description | Run autonomous visual checks for Rust4D rendering changes. Use after touching WGSL shaders, RenderUniforms, camera projection, slice pipeline, primitives, or examples that affect rendering. |
Willow does not do manual rendering checks for this project. If a change affects visual output, verify it yourself with offscreen GPU captures.
Use for camera/movement/physics/slice correctness:
nix develop --command cargo run --example headless_protocol .scratchpad/captures
Read the [STATE] slice_w(...) logs. During WASD phases, slice W must remain
constant. Convert frames with ImageMagick if needed.
Use for geometry, shader, material, and lighting work:
nix develop --command cargo run --example shape_showcase .scratchpad/captures-gallery
Expected:
Make a quick contact sheet:
mkdir -p .scratchpad/captures-gallery/png
for f in .scratchpad/captures-gallery/*_mid_identity.ppm; do
magick "$f" ".scratchpad/captures-gallery/png/$(basename "${f%.ppm}").png"
done
magick .scratchpad/captures-gallery/png/tesseract_mid_identity.png \
.scratchpad/captures-gallery/png/hypersphere_mid_identity.png \
.scratchpad/captures-gallery/png/pentachoron_mid_identity.png +append row1.png
# Repeat rows, then `magick row1.png row2.png row3.png -append contact-sheet.png`
Use +append/-append; ImageMagick montage may need fonts unavailable in
the nix shell.
The current wgpu/naga stack may emit Vulkan validation warning
VUID-StandaloneSpirv-MemorySemantics-10871 for OpAtomicIAdd relaxed
semantics. This is harmless for now and tracked as a wgpu upgrade backlog item.
Do not confuse it with a rendering failure.