القائمة
Required workflow when adding, editing, or removing Vulkan GLSL shader consts — the committed precompiled SPIR-V table must be regenerated or tests fail on drift.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Drive the architect→workhorse flow — turn an approved plan into delegated Sonnet implementation with test and review gates, keeping the main (Opus/Fable) thread as coordinator.
Work a GitHub issue end-to-end — fetch it, verify the claim, turn it into an architect spec, and drive the delegated implementation flow with correct issue references in branches and commits.
Checklist for adding support for a new GGUF model architecture (or a variant of an existing one) to SharpInference.
Cross-check SharpInference numerics against llama.cpp and run accuracy gates. Use when output quality or numerics are in question — new architecture bring-up, kernel or quantization changes, KV-compression work, "model produces garbage" reports.
CLI run recipes for specific models and modes — VibeThinker, Ornith-1.0, Gemma 4 vision, image generation + upscaling, perplexity gating, whole-turn JSON-schema structured output, DSpark speculative decoding, download-model presets. Use when actually running inference for one of these.
استنادا إلى تصنيف SOC المهني
| name | vulkan-shaders |
| description | Required workflow when adding, editing, or removing Vulkan GLSL shader consts — the committed precompiled SPIR-V table must be regenerated or tests fail on drift. |
| paths | src/SharpInference.Vulkan/** |
Shaders are GLSL const strings in src/SharpInference.Vulkan/Shaders.cs,
precompiled to SPIR-V committed in Shaders.Precompiled.g.cs (keyed by FNV-1a
ShaderCompiler.StableHash) so the NativeAOT binary needs no glslc at runtime.
ShaderCompiler.Compile falls back to glslc only on a table miss.
After ANY add/edit/remove of a shader const:
pwsh scripts/gen-spirv.ps1
(builds SharpInference.Vulkan, then runs tools/SpirvGen, which compiles every
shader via glslc — requires the Vulkan SDK on PATH).dotnet test tests/SharpInference.Tests.ForwardPass --filter "FullyQualifiedName~VulkanPrecompiledShaderTests"
— this suite fails on any drift between Shaders.cs and the precompiled table.Shaders.Precompiled.g.cs together with the shader change.Caveats:
Shaders.Precompiled.g.cs.VulkanPrecompiledShaderTests to fail until someone runs the script on a dev
machine. Do not fake table entries to get green.SgemmBf16 and SgemmFp8 need extensions the bundled glslc lacks; they are
listed in SkippedShaders and fall back to runtime compilation by design —
don't "fix" their absence from the table.