用途:实现完成后的复盘检查(Follow-Up),在产品或代码上线前捕捉遗漏、简化代码,属于自我审查流程,而非新功能开发。
主要能力:按六个方向逐项审查并直接修复问题。一,未完成事项:检查本次 diff 中引入的 TODO/FIXME/HACK、用户要求却被跳过的工作、注释掉的代码或占位值、缺失的错误与边界校验,以及回退/遗留代码路径(如有则须明确询问用户保留、移除还是标记,不默认要求向后兼容)。二,更地道:是否符合语言惯例与标准库模式,是否有标准库或已有依赖已提供的手写实现,命名是否遵循项目既有约定,是否出现语言特有反模式。三,更模块化:是否拆分职责过多的函数、抽取重复逻辑、把职责放到正确文件,同时避免为一次性代码造抽象。四,更简单:可删除或合并的代码路径、过度设计、复杂条件简化或提前返回、对不可能状态的防御性代码。五,Web 前端:检查异步数据是否导致首屏后 UI 过期并加守卫,拆分过大的渲染与事件处理,集中共享文案与阈值,同步明暗主题,验证空态、筛选与响应式状态。六,注释与说明可读性:仅针对三行及以上的块注释、docstring 与 Markdown 段落,要求首行摘要、冒号小标题、要点列表、段落间空行;短注释保持原样,默认仍是不加注释。
使用方式:默认以当前分支 diff 为范围,先运行 git diff main...HEAD --name-only,若无分支 diff 则退回暂存改动;审查前完整读取所有改动文件。逐项作答,每条发现引用 file_path:line_number 并直接修复,附一句改动原因。多个独立事项可用 Markdown 表格(如严重程度、来源、发现、修复)呈现,单条或强耦合问题用列表。若无问题则回答 Clean — nothing to follow up on.,不制造额外工作。
适用场景:功能或修复实现完成后、提交合并前的自检。
限制:范围为单个仓库的代码改动,不涉及部署或运行时验证;部分判断依赖项目约定与用户确认,资料未提供具体支持的模型、平台或配置方式。