用途：frontmatter-guard 是 gbrain 的结构校验技能，用于扫描 brain 页面的 YAML frontmatter，发现并修复格式错误，避免错误页面进入 brain 导致同步失败或搜索异常。它只做结构校验，不做引用审计。
主要能力：覆盖八类校验，包括 MISSING_OPEN、MISSING_CLOSE、YAML_PARSE、SLUG_MISMATCH、NULL_BYTES、NESTED_QUOTES、NON_STRING_FIELD、EMPTY_FRONTMATTER。机械性错误（嵌套引号、缺失闭合 ---、空字节、slug 不匹配）可按需自动修复并生成 .bak 备份。校验逻辑与 gbrain doctor 的 frontmatter_integrity 子检查共用同一来源。
使用方式：先运行 gbrain frontmatter audit --json 做只读审计；用 gbrain frontmatter validate <path> --json 校验单个文件或目录，退出码 0 表示干净、1 表示有错；用 gbrain frontmatter validate <path> --fix 修复，修复前会备份到 ~/.gbrain/backups/frontmatter/，可用 --dry-run 预览。托管 brain 上就地 --fix 会被拒绝，需改用 gbrain repair frontmatter --source <id>。可选安装 pre-commit 钩子：gbrain frontmatter install-hook [--source <id>]。
适用场景：brain 页面长期积累后的批量审计、CI 或 pre-commit 阶段拦截错误页面、同步被 hold 的文件排查与修复。
限制：MISSING_OPEN 与 EMPTY_FRONTMATTER 不会自动修复，需人工处理；NON_STRING_FIELD 需手动加引号；YAML_PARSE 是否可自动修复取决于原因。每次 --apply 前需用户确认，--include-ambiguous 的每种解释也需用户确认。写入应通过 put_page / capture 或 YAML 序列化器，避免字符串拼接。具体收费、价格与平台信息暂未提供。