代码合上来之前,先让AI把一道关 - 小团队Code Review的风险清单与提示词写法
一、管理者视角下的痛点
作为小团队的技术负责人,你可能对这样的场景不陌生:
- 合并请求(MR/PR)挂在看板上一整天,没人审。不是大家不负责任,而是每个人手头都有排期,审代码这件“为别人做的事”永远排在最后。
- 终于有人审了,来回只有一句"LGTM"(Looks good to me)。代码里有没有空指针、有没有把密钥写进仓库、事务边界对不对——没人说得清。
- 线上出了一次事故,回溯发现缺陷其实就在那次“快速通过”的合并里。复盘会上没人担责,因为审阅本来就没人有时间认真做。
独立开发者也好不到哪去:自己写的代码自己审,盲区和写代码时是同一组盲区。
Code Review的价值大家都认,但它的成本结构天然不合理:最需要被认真审的代码,往往出现在发布压力最大的时刻。这正是AI能补位的地方——它不需要排期,不会累,愿意第一百次指出同一个空指针问题。
二、AI能帮你做什么:先把职责边界画清楚
从流程管理的角度,我建议把Code Review拆成两层:
第一层:AI做“缺陷筛查”。空引用、资源未释放、SQL拼接、硬编码密钥、越权访问、异常被静默吞掉、并发场景下的竞态条件——这些是模式化、可清单化的问题,AI检查的稳定性甚至高于疲劳状态下的人类。
第二层:人做“设计判断”。架构取舍、业务逻辑是否符合需求、命名风格是否符合团队口味——这些留给有上下文的人。
这样切分后,AI不是替代审阅者,而是把审阅者的时间从“找低级缺陷”中解放出来,聚焦在真正需要人判断的地方。同时,AI审阅是每次合并都执行、标准完全一致的一道关卡,这对风险控制意义重大:流程上你可以说“所有代码合入前必须过一遍AI检查”,这条规则的执行成本几乎为零。
三、落地流程:四步接入现有工作流
- 准备缺陷检查清单。把团队最在意的问题写成明确条目(后面有模板)。不要指望一句“帮我审一下代码”能出好结果——提示词的质量直接决定审阅质量。
- 触发时机。可以在提MR时手动贴代码给AI,也可以用支持Webhook的工具在MR创建时自动触发。小团队从手动开始即可,跑顺了再自动化。
- 输出格式固定。要求AI按“严重级别 + 位置 + 问题说明 + 修改建议”输出,方便直接转成评论或任务。
- 保留人工终审。AI报告作为附件进MR,人基于报告快速复核。合入权限始终在人手里。
四、可复制的提示词模板
你是一名资深代码审阅专家。请对我提供的代码变更进行缺陷检查,输出结构化审阅报告。
【检查清单】(逐项检查,未发现问题的项标记为"通过"):
1. 空指针/未初始化引用风险
2. 资源泄漏(文件、连接、锁未释放)
3. SQL注入、命令注入等注入类风险
4. 硬编码的密钥、密码、内网地址
5. 异常被静默捕获(catch后无日志无处理)
6. 并发/竞态条件(共享可变状态无保护)
7. 事务边界错误(部分提交、缺少回滚)
8. 权限校验缺失(未验证当前用户是否有权操作)
9. 越界访问、类型转换风险
10. 日志中打印敏感信息(手机号、身份证、token)
【输出格式】:
- 每个问题包含:严重级别(阻断/警告/建议)、代码位置、
问题描述、修改建议(附示例代码)
- 最后给出一段总体结论:是否建议合并,需先修复哪些项
【约束】:
- 只报告清单内及确定的高风险问题,不确定的标注"待人工确认"
- 不要评论代码风格和命名偏好
- 不要改写与缺陷无关的代码
代码如下:
<paste_your_diff_here>实践建议:把这个模板存成团队共享片段,每次只需替换最后的diff。清单条目应根据团队事故史持续增删——上个月踩过的坑,就该出现在下个月的清单里。
五、用AI前后的对比
接入前(我们5人小团队某次典型迭代的情况,非客户数据,仅为流程对照):
- MR平均等待审阅超过半天,发布前一天集中“补审”,通过率接近100%,但审阅深度存疑;
- 曾经因为一个被静默吞掉的异常在生产环境排查了一个下午;
- 审阅质量完全取决于当天谁有空、状态好不好。
接入后:
- AI审阅在MR创建后即刻完成,报告固定10项清单逐项给出结论;
- 人的审阅时间从通读全文降为“复核AI标红项 + 看设计”,单个MR审阅时间明显缩短;
- 静默吞异常、硬编码配置这类问题在合入前就被拦截,类似的线上排查再也没有发生过;
- 新人入职时,这份清单同时充当了团队的“质量规范教材”,AI报告本身就在传递标准。
更重要的是管理层面的变化:Code Review从“依赖个人自觉的软流程”变成了“每次必经、标准一致的硬关卡”。风险不再取决于谁碰巧有空。
六、成本与选型提醒
目前主流模型都具备代码审阅能力,选择时重点看三点:对所用语言的理解深度、长diff的上下文处理能力、输出是否稳定遵循你的格式要求。费用方面,以官网价格页为准,建议先小规模试跑一两个迭代周期,评估拦截效果后再固化到流程里。
写在最后
小团队请不起专职审阅岗,但完全可以请一个不睡觉的AI守门员。把缺陷检查清单沉淀成提示词模板,等于把团队的工程经验变成了一道每次都执行的质量闸门。
如果你正在寻找稳定的模型API来跑这套审阅流程,可以看看这个平台:https://api.thistoken.ai/register,注册即用,把上面的模板接进你的工作流试试。
---
本文的示例只需一个 API Key 就能复现:在 https://api.thistoken.ai/register 注册即用。