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

preprocessor-guard-hygiene

GitHub

规范C++头文件的预处理器守卫和宏依赖包含，确保受保护的头文件保持包裹并按层排序，禁止修改与宏配置紧耦合的包含关系。

skills/preprocessor_guard_hygiene/SKILL.md google/filament

Trigger Scenarios

修改C++条件导入语句调整预处理器指令

Install

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

More Options

Use without installing

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.