Agent Skills
› dzhng/skills
› renderer
renderer
GitHub定义基于TypeGPU/WebGPU的GPU渲染架构规范，涵盖着色器、管线、资源生命周期管理及帧编排。指导开发3D模型、数据可视化及游戏渲染应用，确保渲染正确性与性能优化。
触发场景
添加或修改渲染Pass、着色器或管线配置
管理GPU资源（缓冲区、纹理）的生命周期与注册
实现帧同步与多阶段渲染逻辑编排
检查或验证GPU渲染输出结果
安装
npx skills add dzhng/skills --skill renderer -g -y
SKILL.md
Frontmatter
{
"name": "renderer",
"description": "Architecture rules for GPU rendering with TypeGPU\/WebGPU. Use when adding or changing render passes, shaders, frame orchestration, GPU resources, culling, terrain, shadows, or visual performance work."
}
GPU renderer
The renderer is TypeGPU over WebGPU. It draws plain frame inputs the application hands it and never reaches into simulation or app state. These are the flaws that sink a 3D experience; check a change against each before writing it.
- Fixed-view cost never grows with world size. For a fixed camera and render size, submitted geometry, shadow casters, and per-frame lists are bounded by what the view can see or cast into, and screen-space work by pixels. Store the world map-wide; select from it spatially. Frustum clipping does not make vertices free. Compare equal local content and finite view distance: admitting more world changes the workload.
- Detail follows projected size. Correct culling can still admit thousands of tiny meshes. Bound each visible instance’s geometry by its screen footprint as well as bounding the selected population.
- One owner per contract. Frame orchestration, camera, depth convention, targets, culling, lighting, timing, and resource lifetime each have one owner every pass shares. Extend it; a second copy drifts.
- Shared contracts change together. Depth and lighting are engine-wide: every pass reads the same convention and every material the same shading path. A per-pass exception is a future visual bug.
- No GPU resource without a lifetime owner. Everything is allocated through the registry, rebuilds swap in whole, and repeated resize/rebuild/reset returns to baseline.
- Pixels prove correctness, not counters. An optimization is accepted only with an interleaved A/B on the real GPU and an image that shows the subject still drawn correctly.
版本历史
- 0867285 当前 2026-11-02 10:06
-
f6819ca
2026-10-18 16:33
新增对pmndrs/math包CPU端数学计算的规范，明确资源更新频率策略及异步重建处理要求；细化了渲染阶段的语义选择标准。
- c795702 2026-09-08 17:35
