Pre-Commit Gates

仓库提交前使用一个统一门禁入口：

python scripts/pre_commit_gate.py

准备提交时，不要用手动挑选的检查项替代这个入口。

门禁保护什么

门禁用于保持工作区在以下方面一致：

• AGENTS.md 中的 skill 注册
• .codex/config.toml 中 Codex 原生子 agent 登记
• skill 文档 manifest 和源文件指纹
• skill 依赖复核指纹
• README 中的 skill prompt 示例覆盖
• CCN 分类登记表和来源文件的一致性
• 生成后的 Skills 索引和四个必选导航
• 发布状态文件不被 Git 跟踪、不混入源码指纹的边界

这些检查以登记表、源文件指纹和本地生成资料为依据。它们不会逐个运行 skill 的 verify_dependencies.py，也不会发布站点或验证远端正文；实际运行依赖和远端发布验收仍需分别检查。

失败时怎么办

把失败视为漂移信号。先修复底层问题，再重新运行统一门禁。

常见情况：

信号	通常处理方式
Skill 文档变化	复核 docs manifest，并在需要时刷新文档指纹。
依赖相关文件变化	复核运行依赖，并刷新依赖指纹。
Codex 子 agent 配置漂移	复核子仓 .codex/agents/*.toml，运行 python scripts/check_codex_agents_config.py --update 刷新根配置。
注册表不一致	更新对应注册表条目。
README prompt 覆盖失败	补充或更新对应 prompt 示例。

提交规则

只要任一门禁失败，就不要提交。先修复失败项。