用途:对近期代码改动做一次结构化审查,覆盖已暂存、未暂存或指定分支差异,聚焦可执行的发现,跳过细枝末节。
主要能力:按五个维度逐项检查。测试缺口:新增代码路径是否有对应测试、边界与错误路径是否覆盖、现有测试是否仍通过、可测试工具是否缺单测。简化:条件分支能否合并删除、是否存在单次使用的多余抽象、复杂表达式能否拆为具名变量、是否有无法触发的冗余防御代码。命名一致性:新命名是否遵循既有约定、缩写是否统一、函数名是否准确、相似概念是否命名一致。复用机会:重复逻辑能否用现有辅助函数、重复三次以上的模式是否应抽取、现有工具常量类型能否复用、相似函数能否合并。TODO 与注释质量:TODO 是否符合项目前缀约定、是否说明做什么和为什么、是否有过期 TODO、注释是否解释原因而非行为、已知捷径是否缺 TODO。
使用方式:先确定改动范围,未提交用 git diff HEAD,分支差异用 git diff main...HEAD,或由用户提供文件列表;范围不清时询问用户。审查前完整阅读所有改动文件,理解既有模式而非只看 diff。每条发现需标注文件与行号,按维度输出,无发现则写 No issues found。最后给出按投入产出比排序的前 3 至 5 项最有价值改动。
适用场景:提交前自查、分支合并前审查、团队代码规范落地。
限制:资料未提供安装方式、运行环境、平台支持、收费与价格信息;具体命令与输出格式以资料为准。