用途:对 Infrahub 仓库执行只读合规审计,依据 infrahub-skills 插件中的全部规则与最佳实践,生成结构化报告 AUDIT_REPORT.md。适用于部署前检查、接手既有 Infrahub 项目、大规模重构后回归检查、开发流程中的周期性质量门,以及排查 schema 加载、对象同步或流水线故障。
主要能力:审计在九阶段流程中推进——项目结构、schema、对象、Python 组件、交叉引用、注册、最佳实践、部署、YAGNI/修复成本;覆盖 .infrahub.yml、schemas、objects、checks、generators、transforms、menus。报告按严重级别(Critical/High/Medium/Low/Info)汇总,并含站点清单、验证依据、可行性等证据字段。
使用方式:对 Claude 说 “Audit this Infrahub repo” 或 “Run the Infrahub repo auditor”,它扫描当前工作目录并生成 AUDIT_REPORT.md。审计严格只读:仅写自己的报告,不触碰工作树或索引,不运行破坏性 git 命令,Bash 仅用于只读检查,Write 仅用于报告文件。执行前应先阅读 audit-procedure.md(含 Phase 0 只读约束)、rules/audit-cites-all-reference-sites.md、rules/audit-verifies-proposed-syntax.md;涉及 watch 块时阅读 rules/practices-watch-dependencies.md。
限制:审计只产出建议而不修改仓库;所有发现须标明验证方式,无法验证时以 verified_against 字段说明而非降低严重级别;建议的语法需对照被审计版本解析,而非公开文档。价格、平台与运行环境等资料暂未提供。