用途:对项目规则做独立的只读合规门禁,检查变更文件或某个 git ref 是否符合项目规则,不替代 /aif-review 或 /aif-verify。
主要能力:先读取 references/RULES-CHECK-CONTRACT.md 作为判定语义与报告结构的权威来源;再读取 .ai-factory/config.yaml 解析规则文件、规则目录、计划路径、UI 语言、git 配置、基础规则与命名区域规则等,缺失时使用默认值(如 .ai-factory/RULES.md、.ai-factory/rules/、.ai-factory/PLAN.md、.ai-factory/plans/、git.enabled: true、rules.base: .ai-factory/rules/base.md)。若存在 .ai-factory/skill-context/aif-rules-check/SKILL.md 则必须读取,其项目级规则优先于通用规则。
使用方式:解析变更范围与规则来源。提供 git ref 时先执行 git rev-parse --verify <argument> 校验,有效则用 git diff --name-only <argument>...HEAD 与 git diff <argument>...HEAD;无效则询问改用暂存/工作区变更或取消。无参数时优先暂存区 git diff --cached,其次工作区 git diff,再回退分支 diff。规则来源按顺序加载规则文件、基础规则、匹配变更范围的命名区域规则。可选读取计划上下文辅助判断范围。
判定:PASS 为已检查至少一条适用规则且无明确违规;WARN 为无适用规则、证据模糊或无变更文件;FAIL 仅当明确硬规则被清晰违反。违规须绑定具体规则文本与文件/路径或 diff 片段。
限制:命令只读,不修改规则、计划或源码;缺失可选文件或规则层级不完整记为 WARN 而非 FAIL。输出需含总体判定、检查文件、门禁结果、阻断违规、建议修复、建议规则更新,以及末尾机器可读的 aif-gate-result JSON 块(gate 为 rules,status 映射 pass/warn/fail)。