用途:这是一个只读的指导性模块,用于在给出 Shader Graph 建议、设计新图或 SubGraph 架构、审查节点链、以及规划黑板属性、关键字、采样器与 SubGraph 边界之前先阅读,确保建议与真实包源码行为一致,避免使用过时的模型记忆。
主要能力:提供版本差异与可移植性规则、受支持节点子集与可编辑字段、当前技能子集真正能构建的模式、以及评审清单与常见陷阱。事实来源以 shadergraph_get_structure 返回的节点 id、slot id 与实时拓扑为准。
必要用法:在调用本模块任何技能前,若参数是从名称或描述猜测的,先读本文件或通过 GET /skills/recommend?includeSchema=true 获取 schema;已拿到参数定义后可直接 dryRun。运行模式上本模块为 Documentation only,无 REST 技能需要门禁,在 Approval / Auto / Bypass 下均可自由加载。
限制:图编辑仅限 shadergraph_list_supported_nodes 给出的安全节点白名单;指导须落在 Unity 2022.3 与 Unity 6 共同支持的范围内,两者实际交集为 28 个节点,AppendVectorNode 在实时验证中目前仅 Unity 6 可用。不得推荐白名单外节点(除非明确说明现有技能无法构建);不得使用“按节点名编辑”,实现使用序列化的 nodeId 与 slotId;不要假设 Unity 2022.3 有包图模板;不要指示修改 Master Stack、Target、Context、Block 或 SubGraph 输出结构。PropertyNode 需先创建或核实黑板属性。版本、价格与平台等其余信息暂未提供。