Agent Skills
› google/filament
google/filament
GitHub规范 Filament C++ 公共 API 变更时，同步更新 Java (JNI) 和 JavaScript/TypeScript (Embind) 绑定层的流程与指南。
Install All Skills
npx skills add google/filament --all -g -y
Skills in Collection (12)
规范 Filament C++ 公共 API 变更时，同步更新 Java (JNI) 和 JavaScript/TypeScript (Embind) 绑定层的流程与指南。
修改 Filament 公共头文件中的方法、枚举或选项结构体
需要生成或更新跨语言绑定代码
npx skills add google/filament --skill bindings-synchronization -g -y
定义Filament源码的对抗性代码审查协议，专注于并发、内存模型及架构正确性。禁止表面反馈，要求跨函数追踪状态机并消除误报，确保无竞态条件和数据竞争。
请求审查代码片段或PR
分析分支差异或Diff
npx skills add google/filament --skill code-review -g -y
规范C++头文件包含顺序，强制执行分层拓扑结构以优化编译并防止污染。修改代码后需运行自动格式化工具进行排序和检查。
添加或修改C++源文件或头文件中的#include指令
需要整理头文件包含顺序时
npx skills add google/filament --skill cpp-header-inclusion -g -y
规范C++多线程开发，强制使用utils::Mutex/Condition及静态线程安全注解，禁止std::mutex。提供锁守卫、RAII惯例及解决Lambda闭包限制的最佳实践，确保编译期无竞态条件。
设计多线程类
编辑受保护成员字段
实现同步逻辑
npx skills add google/filament --skill cpp-static-thread-safety -g -y
指导在Android设备或模拟器上编译、部署和运行Filament二进制文件及性能基准测试的操作流程。
需要编译Android版本的Filament可执行文件
需要将构建产物推送到Android设备进行测试
需要在Android设备上执行性能基准测试
npx skills add google/filament --skill filament-android-development -g -y
提供Filament引擎桌面端的构建与清理标准流程，涵盖全量清理、Debug/Release编译及Ninja增量构建。特别指出材质生成时的双目录陷阱及正确重建顺序，确保开发调试与发布效率。
需要清理构建产物或重置环境时
编译Filament桌面端Debug版本用于调试时
编译Filament桌面端Release版本用于性能分析时
使用Ninja进行快速迭代构建时
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++头文件自包含，确保其能独立编译。要求显式声明所有依赖，禁止假设前置include已提供类型定义。适用于创建或修改C++头文件时遵守严格规范。
创建新的C++头文件
修改现有C++头文件的include语句
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++源文件或头文件后
完成涉及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
