Agent Skills
› google/filament
google/filament
GitHub规范Filament C++公共API变更时，同步更新Java JNI和JS/TS Embind绑定的SOP。涉及方法、枚举及选项结构体的跨语言一致性维护与代码生成工具调用。
Install All Skills
npx skills add google/filament --all -g -y
Skills in Collection (12)
规范Filament C++公共API变更时，同步更新Java JNI和JS/TS Embind绑定的SOP。涉及方法、枚举及选项结构体的跨语言一致性维护与代码生成工具调用。
修改Filament核心类的公共方法
增删改Options结构体字段
调整Enums或常量定义
npx skills add google/filament --skill bindings-synchronization -g -y
定义 Filament 源码的对抗性代码审查协议，聚焦并发、内存模型、生命周期及 API 契约的正确性。禁止表面反馈，要求跨函数追踪状态机并消除误报，确保无竞态条件和内存错误。
请求进行代码审查
需要审核 PR 或代码差异
npx skills add google/filament --skill code-review -g -y
规范Filament项目中C++头文件的包含顺序与层级，优化编译并防止污染。提供从对应头文件到系统库的严格分层规则及私有头文件排序要求。
修改或添加C++源文件或头文件中的#include指令
需要遵循项目特定的头文件包含层级规范时
npx skills add google/filament --skill cpp-header-inclusion -g -y
规范C++多线程类设计，强制使用utils::Mutex进行静态线程安全检查与同步，解决死锁调试及内存优化问题。
设计多线程类
编辑受保护的成员字段
修复线程安全问题
npx skills add google/filament --skill cpp-static-thread-safety -g -y
指导在Android设备或模拟器上编译、部署及运行Filament二进制文件，执行测试与性能基准测试。
需要在Android设备上编译和运行程序
需要执行Android性能基准测试
npx skills add google/filament --skill filament-android-development -g -y
提供 Filament 构建与清理的标准流程，包括全量清理、Debug/Release 编译及 Ninja 增量构建。重点解决 Shader 生成导致的缓存失效问题，确保构建环境一致性。
需要清理构建产物或重置环境时
编译桌面端 Debug 或 Release 版本时
进行快速迭代构建时
修改了 shader 相关代码后
npx skills add google/filament --skill filament-build-clean -g -y
用于在桌面平台上执行 Filament 项目的单元测试和性能基准测试。支持直接运行编译后的二进制文件，并利用 gtest 和 benchmark 参数进行筛选，适用于本地测试场景。
需要运行单元测试
需要执行性能基准测试
npx skills add google/filament --skill filament-desktop-testing -g -y
强制C++头文件自包含，确保其能独立编译。要求显式包含依赖类型声明的头文件，禁止假设前置包含已提供类型，防止隐式依赖导致编译失败。
创建或修改C++头文件时
解决头文件编译依赖问题时
npx skills add google/filament --skill header-self-containment -g -y
用于C++代码中预处理指令和头文件包含的规范化。确保带条件编译的头文件保持包裹并按层排序，禁止修改与宏紧密耦合的包含关系，以维护代码整洁和构建安全。
修改C++条件导入或预处理指令时
执行头文件重组织脚本后需验证包含卫生性时
npx skills add google/filament --skill preprocessor-guard-hygiene -g -y
针对C++源码或头文件修改的标准化验证流程，包括格式化、编译引擎及运行核心测试。若涉及公开API变更，还需检查Java和JS/TS绑定的同步情况，确保代码质量与一致性。
修改了C++源文件或头文件
需要执行构建前验证
npx skills add google/filament --skill verification-protocols -g -y
规范 Filament 图形引擎对象生命周期管理，指导实体、组件及 GPU 资源的正确创建与销毁，防止内存泄漏和段错误。
初始化渲染管线
分配或释放 GPU 缓冲区
处理 Filament 实体与组件生命周期
npx skills add google/filament --skill filament-lifetime -g -y
规范Filament引擎数学原语与命名约定，指导使用filament::math命名空间内的向量、矩阵及四元数类型，禁止引入外部数学库，确保图形计算代码的一致性与正确性。
进行坐标变换
执行向量数学运算
设置投影矩阵
npx skills add google/filament --skill filament-math -g -y
