Code Review Pro 是一个面向代码审查场景的技能,目标是找出真正重要的问题、为每个问题提供证据,并给出修复方式,而不是堆砌大量不确定的猜测。
用途与审查范围 它可对粘贴的代码片段、指定文件、工作区 diff(git diff、git diff --staged)或分支与基线的差异(git diff main...HEAD)进行审查。对于 diff,重点看改动行,但会阅读足够的周边代码以理解调用方式。
工作流程
- 先确定审查范围。
- 在判断前先了解上下文:识别语言、框架与版本(如 package.json、pyproject.toml、go.mod),弄清代码如何被调用(HTTP 处理器、任务、CLI、库),哪些输入不可信,以及仓库约定(linter、CLAUDE.md、既有模式)。资料强调同一写法在不同框架中安全性可能不同,例如 React 会转义 JSX 文本,XSS 风险集中在 dangerouslySetInnerHTML、href 值和原始 HTML 输出点。
- 按优先级审查:安全、正确性与边界情况、性能、可维护性与约定,并参考 checklist。
- 报告前逐条验证:追踪数据来源、是否可被攻击者或真实用户控制、上游是否已校验或转义、是否有测试覆盖;能运行代码时用小型测试或脚本复现;无法支撑的发现应丢弃,其余标注置信度。
- 按严重程度排序撰写报告,将同一问题的多处实例合并为一条并列出所有位置。
严重程度划分 Critical:当前可被利用或造成数据丢失/损坏,如用户输入注入、认证绕过、代码中的密钥、真实数据上的访问控制失效。 High:现实条件下很可能的缺陷或漏洞,如共享状态竞态、缺失授权检查、面向用户路径上的无界查询、吞掉错误掩盖失败。 Medium:当前正确但脆弱,如可信调用方背后缺少输入校验、小数据量上的 N+1 查询、状态归属混乱。 Low:风格、命名、小简化;最多报告少量,且跳过 linter 或格式化工具已强制的内容。
输出格式 报告以“Code Review: [范围]”为标题,先给出判定(Ship / Ship after fixes / Do not ship)及一句话理由,再列出各级别问题数量。每个问题包含位置、类别、置信度、证据、影响、当前代码与修复代码;High、Medium 依次展开,Low 以一行列出。报告末尾包含“What is solid”(两三项做得好的具体之处)和“Not reviewed”(超出范围或无法验证的文件与关注点)。
常见陷阱 资料列出导致差评的陷阱:不读调用方就报告“缺少校验”;给泛泛建议而非指明具体失败;把风格问题当作高严重度;使用过时规则(如 React Compiler 启用后 useMemo/useCallback 建议变化、Node 内置 API);给出无法编译的修复;一次性报告超过约 15 条问题淹没关键项,长尾问题应一行概括。
适用场景与限制 适用于需要结构化、可验证、按优先级排序的代码审查,尤其是安全敏感或需要给出可落地修复的场景。资料未说明其运行环境、安装方式、收费标准或与特定平台的集成方式,相关事实暂未提供。