SuperAPI AI 工具集

webgpu-agents-quality-validator

智能体与模型

查看项目

更新于 10-15 22:18

技能介绍

用途:在信任生成的 WebGPU 宿主代码与 WGSL 着色器之前,或审计既有 WebGPU 代码库时,做正确性检查。它是审查类技能:只检查与分流,不重新教学 API。

主要能力:按固定顺序运行二值通过/失败检查清单,覆盖初始化、特性与限制、缓冲区、对齐、纹理与采样器、绑定组与布局、管线、渲染通道、WGSL 正确性、计算正确性、错误处理与调试、性能。每个缺陷被路由到对应权威修复技能,例如初始化缺陷路由到 webgpu-core-architecture 或 webgpu-errors-device-loss,对齐缺陷路由到 webgpu-core-memory-model 等。

关键校验点:requestAdapter() 可能返回 null,必须做适配器空值检查;在任何 GPU 资源创建前必须挂上 device.lost 处理器;device.queue 必须作为属性读取;requiredFeatures 每项必须经 adapter.features.has 检测;缓冲区使用标志组合必须合法;大小按 4 对齐、动态偏移按 256、bytesPerRow 按 256;纹理用途与格式匹配;@group/@binding 与布局条目一致;管线格式与渲染通道附件一致且不在帧循环内构建;WGSL 不可递归、switch 需有 default、uniform 结构体布局需考虑 vec3 16 字节对齐;@compute 需声明 @workgroup_size;错误用 pushErrorScope/popErrorScope 包裹等。

使用方式:按固定顺序逐条执行清单,每条为通过/失败;发现缺陷后用决策树路由到权威技能。遇到 1.0 稳定规范中不存在的 API 名称、描述符字段、枚举值或 WGSL 内建,视为幻觉 API,属硬失败。

限制:不重新讲解 API,不替代权威修复技能;只报告传染链中的第一个缺陷,因为后续错误多为下游噪音。资料未说明其运行平台、安装命令、收费与依赖要求。