SuperAPI AI 工具集

tiered-audit

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:对代码库做分层审计,适合发布前质量评估、合并前查看分支改动、排查不稳定或频繁变更的区域。不适用于单文件审查、纯架构审查或单次提交审查。

主要能力:分三层执行。第一层 Git 历史审计始终先运行,通过 git log、diff 统计和 blame 找出关注区域,不读取源码;运行 python3 "${CLAUDE_PLUGIN_ROOT}/scripts/tiered_audit.py" --base {base},加 --json 可输出 escalation_targets 与升级判定。它执行四类 git 查询(文件改动频率、修复性提交主题、单次提交 diff 大小、新增文件),按阈值标记(模块内 3 个以上文件且某文件改动超过两次、单次提交改动 200 行以上、模块内新增 5 个以上文件),并输出 [E{n}] 证据。第二层仅针对第一层标记的区域逐个审计,读取源码、检查模式与缺陷、验证测试覆盖、文档时效与架构契合度。第三层为全库审计,需用户明确批准,建议按区域使用独立会话与文件协调,而非并行子代理。

使用方式:第一层结果写入 .coordination/agents/tier1-audit.findings.md,第二层每个区域一个文件 .coordination/agents/tier2-{area-name}.findings.md。输出契约要求 summary 与 evidence 段落,第一层最少 3 条证据,第二层最少 8 条。每层完成后需验证文件存在且证据数达标。可将结果写入 .review/findings.json 并运行引用校验器,被拒绝的条目应删除或标记 UNVERIFIED。

限制:若已知繁忙分支返回空报告,说明提交范围有误,需先用 git merge-base {base} HEAD 确认 {base} 可解析。第三层必须获得用户批准。资料未提供具体收费、平台支持或性能数据。