用途:审查代码变更、PR、diff、commit、patch,或审计现有代码库模块质量;也可作为审查阶段的参考标准。不适用于纯文档变更、配置调整(除非涉及安全)、生成代码与数据文件。
主要能力:覆盖设计、功能、复杂度、测试、命名、注释、风格、文档、每一行、上下文共十维度。设计审查最关键,要求判断模块交互与系统集成是否合理;功能审查关注意图、边界情况、并发与 UI;复杂度审查警惕过度工程,解决当前已知问题;测试要求与产品代码同 CL,确保损坏时真的失败;风格问题以风格指南为绝对权威,纯风格偏好用 Nit 标注;文档需随构建、测试、交互方式变更同步更新。
使用方式:先用 git diff --cached 查看暂存变更,为空则用 git diff HEAD~1 HEAD。三步法浏览:先读描述理解意图,再审查核心主文件(发现重大设计问题立即评论),最后按逻辑顺序审查其余部分。输出采用标准模板:审查总结、设计层面、关键问题、建议、好的实践、问题。评论带严重程度标签 Nit / Optional / Consider / FYI,解释原因而非只提问题。
适用场景:日常代码审查、CR 评审、审计模块质量、作为提交流水线的审查标准参考。不适用纯文档与自动格式化代码。
限制与要求:需拒绝“以后再清理”,除非立即有后续清理 CL;大 CL 超 1000 行应要求拆分;重构与功能变更须分开提交。缺失事实:具体运行命令、安装方式、平台支持、收费情况暂未提供。