fresh-eyes 是一个面向编码智能体的审查技能,核心是让智能体在完成实现后,用全新视角重新阅读自己刚刚编写或修改的代码,从而发现深陷实现细节时容易忽略的明显缺陷、错误和混乱之处。适合在完成功能或修复之后、提交改动之前、感觉哪里不对时,以及长时间编码会话之后使用。
流程分为四步。第一,识别改动代码:找出本次会话中修改的所有文件;若不清楚,可询问用户或查看最近的 git 改动,命令为 git diff --name-only HEAD~1 与 git diff --name-only --cached。第二,以全新视角重读:完整阅读每个修改文件,假装从未见过这段代码,重点检查逻辑错误(如差一错误、条件反转)、明显缺陷(如变量名拼写错误、复制粘贴错误、遗漏 return、调用了错误的函数)、遗漏部分(如错误处理缺口、未覆盖的边界情况、缺少清理代码、边界处缺少校验)以及易造成困惑的风险(如误导性变量名、缺少注释的复杂逻辑、文件内模式不一致、无说明的魔法数字)。第三,修复问题:对每个发现的问题,用一句话说明错在哪里,立即修复,然后继续下一个;不要请求许可,直接修复明显问题。第四,汇报总结:给出简洁摘要,列出修复的问题及位置;若无问题,也说明已审查的文件数量。
技能明确列出不应做的事:不重构可正常工作的代码、不添加功能、不改动风格偏好、不做过早优化、不给显而易见的代码加注释、不重排文件结构。只聚焦缺陷、错误和问题;能用且未坏就保持不变。检查清单包括:变量使用前是否都初始化、函数是否都返回应有结果、循环是否都能正确终止、条件是否都处理了两个分支、异步操作是否都 await、错误是否都被捕获或传播、资源是否都清理、边界情况(空、null、零、负数)是否都处理。
关于支持的平台、安装方式、收费情况或价格,资料中暂未提供。