Vulkan 渲染专家技能

English | 中文

这是一个 Vulkan 渲染工程专家技能包。它不是 Vulkan 入门教程，而是为真实渲染工程任务准备的运行时知识库：用于在处理 Vulkan 设计、实现、调试、优化和验证问题时，按工程链路组织判断、引用规则、API 细节、调试路径和回归验证。

适用场景

• 设计 Vulkan 渲染管线、Render Pass、Dynamic Rendering、Render Graph 或 RHI 抽象。
• 实现或修改 Descriptor、Pipeline、Command Buffer、Buffer/Image、Swapchain、同步和资源生命周期代码。
• 排查黑屏、闪烁、崩溃、GPU hang、device lost、Validation Error、image layout、descriptor binding 等问题。
• 分析移动端 Vulkan 性能瓶颈，包括 bandwidth、fullscreen pass、barrier、descriptor 更新和 pipeline 创建卡顿。
• 处理 Android Vulkan 的 ANativeWindow、Surface 生命周期、pause/resume、横竖屏和 swapchain recreate。
• 在不确定 API 细节时，区分规范来源、经验判断和需要回查的内容。
• 分析真实 Vulkan / 图形引擎仓库，建立 [CODE] 源码证据、Architecture Map、源码级影响面和 coding-agent 实施计划。

技能结构

.
├── SKILL.md                 # 技能入口，定义触发、加载顺序和输出规则
├── agents/                  # 可选的工具或平台集成配置
├── assets/                  # README 和发布页使用的图片资产
└── references/              # Vulkan 专家知识库，按任务渐进加载

references/ 按职责拆分为 8 个模块：

核心能力

这个技能要求输出始终给出可执行的 Vulkan 路径，而不是停留在概念解释：

1. 先给结论和最高优先级判断。
2. 给出 Vulkan 对象链路、关键 API、资源状态、layout 或同步关系。
3. 标出 descriptor、pipeline、command buffer、image layout、lifetime、Android lifecycle 等高风险点。
4. 给出最小验证方式，例如 Validation Layer、RenderDoc、AGI、logcat、trace、counter 或 targeted assert。
5. 对不确定 API 细节明确要求回查 Vulkan Spec、Registry、官方示例或平台文档。

v1.0.9：轻量入口（2026-10-17）

启动只加载全部 19 条硬规则、唯一路由入口段落及命中类型，再按需读取模板、准确性规则与检索协议。保留全部 8 模块、触发词、宿主配置、Evidence Map / Architecture Map，以及结论前必做的 G1-G6 验证。

稳定锚点与全文读取回退见检索协议，旧规则去向见规则迁移映射。实际模型 token 降低 30% 是待测目标；静态体积变化不能证明 live 行为或质量不回退，未取得对应证据前不宣称达标。

安装与调用

本技能遵循 Agent Skills 规范：仓库根目录即技能目录，SKILL.md 是入口，references/ 按需加载。

Claude Code

git clone https://github.com/oahc09/vulkan-rendering-expert-skill ~/.claude/skills/vulkan-rendering-expert-skill

放入技能目录后，描述 Vulkan 问题即可自动触发；也可显式说"使用 vulkan-rendering-expert-skill"。

TraeCode / Trae

在技能管理中添加本仓库目录作为本地技能，或从技能市场搜索安装。

其他支持 Agent Skills 的宿主（Cursor、VS Code 插件等）

凡能读取 SKILL.md frontmatter 并按其指令加载 references/ 文件的宿主均可使用。宿主不支持技能机制时，可把 SKILL.md 全文粘贴为系统提示词，技能以降级模式工作；仍需按入口要求提供硬规则与命中参考段落（自动加载失效，不能仅凭入口全文声称完整执行）。

提问示例库

以下提问可直接复制使用，括号内为会触发的模块：

1. Android Vulkan 前后台切换后黑屏，给出对象链路、最可能原因和验证步骤。（debug playbook + Android case）
2. vkCreateGraphicsPipelines 报 VUID 错误，帮我解码这条 Validation 消息：（validation 解码 playbook）