Free Preview
先试读:用Claude Code做代码审查:普通人也能看懂改了什么
如果让 Claude Code 只评价代码好不好,它很容易给出一段泛泛而谈的建议。
很多人让 AI 做代码审查,会直接说:“帮我看看这段代码有没有问题。”这句话太宽了。AI 可能会检查命名、格式、重复逻辑,也可能会给一些无关紧要的优化建议,但它未必会抓住真正危险的地方。
这篇能解决什么问题
- 把一句模糊需求改成 AI 能执行、你能验收的任务卡。
- 知道执行前要先检查哪些文件、风险点和验证命令。
- 避免 AI 顺手改无关内容,最后只交付可审、可回退的改动。
付费后能看到哪些内容
- 代码审查不是问“有没有问题”,而是问“哪里可能出事”
- 先看本次改了什么,不要让 AI 重新审全项目
- 把问题分成 P0、P1、P2,比列一堆建议更有用
- 普通人不需要看懂每行代码,但要看懂影响
可以先照着试的一句话
这是我要改的功能:___。请先阅读项目结构,列出会动哪些文件、风险点和验证命令;等我确认范围后,再开始做最小改动。
试读到这里先判断是否对你的任务有用;完整文章会继续展开步骤、案例、模板和避坑细节。
代码审查不是问“有没有问题”,而是问“哪里可能出事”
如果让 Claude Code 只评价代码好不好,它很容易给出一段泛泛而谈的建议。
很多人让 AI 做代码审查,会直接说:“帮我看看这段代码有没有问题。”这句话太宽了。AI 可能会检查命名、格式、重复逻辑,也可能会给一些无关紧要的优化建议,但它未必会抓住真正危险的地方。
更好的审查目标是:这次改动会不会让用户打不开页面、会员权限失效、支付流程异常、数据被误删、搜索索引漏更新、移动端布局坏掉。这些才是项目真正关心的风险。
低价值审查
只看代码风格、变量名、缩进、是否可以抽函数。
高价值审查
看行为变化、用户影响、权限边界、数据风险、验证是否充分。
给工程师看
指出具体文件、代码位置、触发条件和建议改法。
给负责人看
翻译成业务影响:能不能上线、哪里要复测、需要谁确认。
先看本次改了什么,不要让 AI 重新审全项目
审查的核心对象是改动本身,而不是整个代码库。
Claude Code 做审查时,最适合从 diff 开始。你可以让它读取当前改动,或者比较某个分支和主分支的差异。它应该先回答三个问题:改了哪些文件、这些文件分别负责什么、改动背后的意图是什么。
如果它连“这次到底改了什么”都还没说清楚,就开始评价“架构可以优化”,这个审查就已经偏了。
请先只读当前模拟项目的改动,不要修改文件。
请按下面格式输出:
1. 本次修改文件清单
2. 每个文件原本负责什么
3. 每个文件本次改了什么行为
4. 哪些改动可能影响用户可见功能
5. 哪些改动可能影响登录、权限、支付、数据、部署
不要先给优化建议,先把事实列清楚。
这段提示词的重点是“先事实,后判断”。Claude Code 如果一开始就给结论,容易忽略上下文;先列事实,你就能判断它有没有读懂改动。
把问题分成 P0、P1、P2,比列一堆建议更有用
一个好的审查结果,应该让你知道先处理什么,什么可以晚点处理。
| 等级 | 含义 | 示例 | 处理方式 |
|---|---|---|---|
| P0 | 会直接阻断用户或造成数据/权限事故 | 未登录用户绕过权限、支付成功后权限没写入、批量删除条件错误 | 必须修复后才能上线 |
| P1 | 主要流程可能异常,但有绕行方式 | 移动端按钮遮挡、部分结果页 404、搜索入口漏新文章 | 上线前应修复或明确接受风险 |
| P2 | 体验、可维护性或次要问题 | 文案不统一、重复代码、边界提示不够清楚 | 可排期处理 |
你可以要求 Claude Code 只输出真正影响行为的问题,避免它把“变量名可以更短”“这里可以抽函数”这类建议塞满审查报告。不是这些建议没价值,而是它们不应该淹没真正会影响用户的风险。
任何涉及 auth、permission、payment、order、deploy、migration、delete、webhook、email 的改动,都应该自动提高风险等级。即使改动看起来很小,也要问清楚触发条件和失败后果。
普通人不需要看懂每行代码,但要看懂影响
Claude Code 的一个重要价值,是把技术 diff 翻译成能决策的语言。
如果你不是程序员,也可以让 Claude Code 用“负责人能看懂”的方式总结审查结果。不要让它只说“这里的条件判断有问题”,而要让它说:“这种条件下,已购买用户可能被误判为未购买,因此会看到购买提示。”
审查报告必须回答:现在怎么证明它是对的
没有验证建议的代码审查,只能算阅读笔记。
一个改动能不能上线,不只看代码看起来是否正确,还要看有没有验证。Claude Code 应该帮你判断:现有测试覆盖了什么,没覆盖什么,哪些地方需要手动复测。
自动测试
单元测试、组件测试、端到端测试、脚本校验,适合证明逻辑不退化。
手动复测
登录、购买、移动端菜单、表单提交、文件上传等真实体验必须实际点一遍。
线上验证
部署后检查正式路径、静态资源、缓存、旧节点、搜索入口和权限状态。
如果 Claude Code 发现没有测试,不应该直接说“建议补测试”就结束。更好的输出是:最小应该补哪一类测试;如果暂时不补,至少应该怎么手动验证;上线后应该看哪些页面或日志。
一套能直接用的 Claude Code 审查提示词
把审查目标说清楚,结果才不会变成泛泛的代码点评。
请对当前模拟项目的改动做代码审查,不要修改文件。
审查目标:
1. 先列出本次修改文件和行为变化
2. 按 P0/P1/P2 输出问题,P0 最严重
3. 优先关注登录、权限、支付、数据、部署、外部发送、移动端体验
4. 不要把纯风格建议放在主要问题里
5. 每个问题都要说明:
- 文件/位置
- 触发条件
- 用户影响
- 建议修复方向
- 应该如何验证
6. 最后用普通人能看懂的话总结:是否建议上线
- 先读 diff,不要重新审整个项目。
- 先列事实,再判断风险。
- 按 P0/P1/P2 分级,避免建议没有优先级。
- 把技术问题翻译成用户影响和上线判断。
- 每个风险都要有验证方式,不能只说“可能有问题”。