SuperAPI AI 工具集

repo-auditor

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:在完成代码编辑、准备 git commit 或开 PR 前进行改动审查;也可在解决合并冲突后,或用户询问“这个 PR 是否就绪”时使用。不适合探索性/只读工作,也不适合纯格式变更(lint/format 已覆盖)。

输入:base(可选,基准 ref,默认 origin/main)、paths(可选,限制到特定路径)。

工作流:先执行 git diff <base>...HEAD --name-only 和 git diff <base>...HEAD;对每个变更文件加载 references/audit-checklist.md 并逐项走查;检查测试(新增公开函数无对应测试则标记)、检查导入(未使用或缺失导入则标记)、检查风格一致性(新代码是否匹配邻近代码习惯)、检查文档(是否需要更新 AGENTS.md / MEMORY.md / README,遗漏则标记);最后生成结构化报告。

输出:审计报告,含已审查文件数、警告数、阻断项数,并分别列出 Blockers 与 Warnings(格式为 file:line — 问题)。

成功标准:0 个阻断项可开 PR,或所有阻断项已被用户明确确认。

限制与失败模式:diff 超过 1k 行时要求用户缩小范围;无法读取基准 ref 时报错并给出说明。