合规闸门

十五道关卡Copy Anchor Link

闸门只运行可由机器检查的校验器。推理判断类关卡所要求的推理判断，以及每个机械 + 推理判断类关卡中的推理判断部分，都在评审中评估。

严重级别阶梯Copy Anchor Link

闸门没有关键、重要或建议性的分级，也没有两项发现的阈值。不带 --strict（或 APOTHEM_CONFORMITY_STRICT=1）时，闸门只报告发现项，并以 0 退出。带 --strict 时，单文件或钩子检查在任一匹配器失败时以 2 退出；语料库运行（--all 或 --all-perwrite）在某个阻断性校验器或匹配器失败时以 2 退出；建议性发现项只报告。已安装的 Write/Edit 钩子不传递 --strict，因此它只报告发现项，写入会继续进行，除非其环境中设置了 APOTHEM_CONFORMITY_STRICT=1。

校验器Copy Anchor Link

机械部分位于 src/apothem/conformity/，由 src/apothem/conformity/gate.py 编排。每个校验器以下列三种方式之一运行：

• per-write：在每次待处理的写入时运行（--hook），或用 --all-perwrite 对每个已跟踪的文件运行。
• standalone：用 --all 在整个仓库范围内运行，或用 --check <name> 逐个运行。
• change-set：针对已暂存的差异，直接以 python -m apothem.conformity.semver_stability_grep --staged 运行，不经由闸门。

下表由校验器模块生成。

The conformity package ships 54 validators: 22 per-write, 31 standalone and 1 change-set. The gate registers the per-write and standalone ones.

运行闸门Copy Anchor Link

在已安装的工具上，闸门会自动运行：Claude Code 的 settings.json 将其接入为一个 PreToolUse 钩子，在每次 Write/Edit 之前调用位于 ~/.claude/.apothem/support/conformity/gate.py 的物化副本。随后闸门只检查其钩子范围内的写入，范围之外的写入会无声通过；该范围列于运行合规闸门。在源码检出中，模块形式驱动同一套代码；请在下面每条 python 命令前加上 PYTHONPATH=src。闸门默认是建议性的：它报告发现项并以 0 退出。添加 --strict 可在出现阻断性发现项时以 2 退出。未知的校验器名称以 3 退出。

# Every standalone validator across the repository:
python -m apothem.conformity.gate --all .

# The same sweep, failing on a blocking finding (the CI form):
python -m apothem.conformity.gate --all --strict .

# Every per-write validator against every tracked file:
python -m apothem.conformity.gate --all-perwrite .

# One validator by name (names come from --list):
python -m apothem.conformity.gate --check naming-grep .

# List every registered validator as JSON:
python -m apothem.conformity.gate --list

# Single-file dispatch (mimics the PreToolUse hook):
echo '{"tool_input": {"file_path": "path/to/file", "content": "..."}}' \
    | python -m apothem.conformity.gate --hook

python -m apothem.conformity.gate --help 会打印用法摘要。完整流程参见运行合规闸门。

参考Copy Anchor Link

• 预发布闸门登记册——规范的关卡定义
• 对外合规登记册——M1-M15 的详细语义
• 横切强制规定——强制规定的权威来源
• 性能纪律——按类别划分的运行时预算