菜单
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.
用 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.
Run autonomous visual checks for Rust4D rendering changes. Use after touching WGSL shaders, RenderUniforms, camera projection, slice pipeline, primitives, or examples that affect rendering.
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 | production-readiness |
| description | 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. |
Run this before opening a PR or calling a feature branch done.
nix develop --command cargo fmt --all -- --check
nix develop --command cargo clippy --workspace --all-targets -- -D warnings
nix develop --command bash -c 'RUSTDOCFLAGS=-Dwarnings cargo doc --workspace --no-deps'
nix develop --command cargo test --workspace
nix develop --command cargo test --test slice_invariant
No warnings. No ignored failures unless already documented.
For rendering-affecting work:
nix develop --command cargo run --example shape_showcase .scratchpad/captures-gallery
nix develop --command cargo run --example headless_protocol .scratchpad/captures
Inspect at least one contact sheet or representative PNGs. Do not ask Willow to verify visually.
docs/README.md links any new docdocs/developer-guide.md updated for workflows/architecture changesdocs/4d-math.md updated for math/convention changesdocs/shapes.md updated for primitive changes.agents/skills/* updated if a workflow changedRUSTDOCFLAGS=-Dwarnings catches this)scratchpad/board.md with correct # column namesPR body should include:
Mention exact test counts and capture counts where relevant.