Agent Skills › google/filament › preprocessor-guard-hygiene

preprocessor-guard-hygiene

GitHub

规范C++头文件预处理守卫和宏依赖包含的卫生规则，确保条件导入正确包裹并按层排序，禁止修改与宏紧密耦合的包含指令。

skills/preprocessor_guard_hygiene/SKILL.md google/filament

触发场景

修改C++条件导入或预处理指令时涉及头文件重组织或包含顺序调整时

安装

npx skills add google/filament --skill preprocessor-guard-hygiene -g -y

更多选项

不安装直接使用

npx skills use google/filament@preprocessor-guard-hygiene

指定 Agent (Claude Code)

npx skills add google/filament --skill preprocessor-guard-hygiene -a claude-code -g -y

安装 repo 全部 skill

npx skills add google/filament --all -g -y

预览 repo 内 skill

npx skills add google/filament --list

SKILL.md

Frontmatter

{
    "name": "preprocessor-guard-hygiene",
    "description": "Enforce preprocessor guard rules and macro-dependent inclusion hygiene in C++. Use this skill when modifying conditional imports or preprocessor directives."
}

Preprocessor Guard Hygiene

Simple Guarded Includes: Headers wrapped inside single-line preprocessor guards (like #if __EXCEPTIONS or #if defined(__ARM_NEON)) must remain wrapped and are sorted alphabetically within their correct layer.
Macro-Dependent Templating: Never modify or split includes that are tightly coupled with macro configurations (such as #define UTILS_PRIVATE_IMPLEMENTATION_NON_COPYABLE in ostream.cpp). The reorganize_headers.py safety check will automatically detect and skip these; respect these skips.