用途:对比工作分支与其基线,找出 AI 生成的代码冗余(slop),并提出删除或替换建议,全程不修改文件。
主要能力:
- 解析基线,按以下顺序取第一个可用引用:用户显式提供的 ref(如 develop、commit SHA 或 tag);上游跟踪分支(git rev-parse --abbrev-ref --symbolic-full-name @{u});仓库默认分支(git symbolic-ref refs/remotes/origin/HEAD,回退 main 再 master);以及 HEAD 与上述引用之间的 merge-base(git merge-base)。报告中需写明解析出的基线,供用户确认。
- 审查注释,默认视为冗余。注释只有同时满足以下三点才保留:持久(六个月后无 diff 上下文仍可读,不叙述改动、不含工单标签或 TODO);非冗余(代码本身无法表达的信息,不重述符号名、类型或下一行);承重(缺失会误导读者,例如非显然的不变量、外部 bug 的规避方案并附链接、刻意偏离、性能或安全取舍)。不确定时标记为冗余;不得因文件本身注释多而放宽标准。
- 审查其他冗余:该代码区域不常见的防御性检查或 try/catch(尤其是可信或已验证路径);用 any 强转绕过类型问题;与同文件风格不一致的写法。
输出格式:不编辑文件,输出结构化列表,每条包含 File:line、Category(comment | defensive-check | any-cast | style)、Snippet(待删除或替换的确切行,≤5 行)、Suggested replacement(确切替换内容或 delete)、Why(一句话)。结尾用 1–3 句总结建议清理内容与解析出的基线,并告知用户可逐条接受建议或要求全部应用。
限制:仅审查 diff 中新增内容;不修改文件。具体安装方式、运行命令、支持语言与平台等资料暂未提供。