求推荐一个好用的 AI 代码审查提示词
AI 深度解读
背景
随着大语言模型（LLM）在软件开发领域的广泛应用，越来越多开发者尝试利用 AI 辅助进行代码审查。然而，简单的指令如“帮我审查这段代码”往往导致输出泛泛而谈、缺乏针对性，甚至给出不必要的大规模重构建议。LINUX DO 社区的一则讨论帖中，一位用户寻求更精细化的代码审查提示词（Prompt），希望 AI 能准确识别潜在 Bug、安全漏洞、性能瓶颈、可读性及最佳实践，并希望标注问题位置与严重程度，附带修改建议。该帖引发了多位参与者的经验分享，探讨了如何针对不同模型（Claude、ChatGPT、Gemini、Codex）以及不同粒度（单个文件 vs 整个项目）设计提示词。
核心内容
原帖的核心需求是寻找一套高质量的 AI 代码审查 Prompt，满足以下六项检查维度：
- 潜在 Bug 和边界条件：识别难以发现的逻辑错误、空指针、数组越界、并发竞争等。
- 安全漏洞：检测 SQL 注入、XSS、敏感信息泄露、不安全的序列化等常见安全问题。
- 性能问题：指出不必要的循环、重复计算、内存泄漏、不必要的 I/O 操作等。
- 代码可读性和可维护性：评价命名规范、注释质量、函数长度、单一职责等。
- 是否符合最佳实践：检查语言/框架惯用写法、设计模式应用、测试覆盖率等。
- 问题定位与严重程度：希望 AI 能标注具体行号或代码片段，并划分 Critical/Major/Minor 等级，最后给出修复建议。
发帖者指出，直接让 AI“审查这段代码”效果不理想，结果笼统，且容易产生“过度重构”的建议。因此提出了三个延伸问题：
- 是否有长期使用的成熟模板？ 期望社区分享经过验证的 Prompt 文本。
- 单个文件与整个项目的 Prompt 是否需要区别设计？ 例如项目级审查需要关注依赖关系、模块耦合、架构一致性等，而文件级则聚焦于内部逻辑。
- 不同模型（Claude、ChatGPT、Gemini、Codex）是否需要不同写法？ 因为各模型在处理长上下文、理解技术细节、遵循指令方面的能力有差异。
此外，发帖者特别关心如何减少误报，并让 AI 优先报告真正重要的问题（而非风格偏好）。参与讨论的用户提供了若干经验：例如在 Prompt 中加入“如果问题不严重或属于风格争议，请忽略”的约束；或者要求 AI 按严重程度排序输出，只列出前 5-10 个问题；还有人推荐使用结构化模板，要求 AI 按“位置→严重性→类型→描述→修复建议”的格式输出。
关键要点
- 明确审查维度：最佳 Prompt 应显式列出 Bug、安全、性能、可读性、最佳实践五个维度，并限定输出格式（行号、严重等级、建议）。
- 区分文件级与项目级：文件级 Prompt 侧重函数内逻辑；项目级需额外关注模块间耦合、依赖注入、测试覆盖率等全局问题，可要求 AI 提供架构级建议。
- 模型适配技巧：
- Claude：善于理解长上下文，可给定详细的代码库背景，但需明确要求避免过度重构。
- ChatGPT / Gemini：适合单文件快速审查，建议用思维链（Chain-of-Thought）引导逐步分析。
- Codex（或其他代码专用模型）：可结合代码补全特性，要求以代码注释形式直接嵌入建议。
- 减少误报方法：
- 在 Prompt 中强调“只报告确定的问题”，对风格争议或轻微违规（如空格、缩进）直接忽略。
- 限制输出数量（如“最多列出最严重的5个问题”）。
- 要求模型先解释推理过程再做结论，避免幻觉。
- 常用模板结构：一个推荐的 Prompt 开头示例——“你是一位资深软件工程师，请按以下要求审查代码：1. 指出所有可能引起运行时错误或逻辑错误的代码行，标注严重性。2. 检查安全漏洞，例如注入、权限泄漏。3. 识别性能瓶颈并建议优化。4. 评价代码可读性，只提出严重影响维护的问题。5. 最后输出一个表格，包含位置、类型、严重性（Critical/Major/Minor）、描述、建议修复。”
意义与影响
该讨论反映了开发者对 AI 代码审查从“能用”到“好用”的进阶需求。通过设计精细化的 Prompt，可以显著提升 LLM 在审查任务中的准确性和实用性，减少无意义的输出。这促使 AI 工具和用户共同探索更高效的协作方式：
- 对开发者：掌握 Prompt 工程技巧后，可将 AI 审查真正融入持续集成流程，节省人工 Code Review 时间，并优先发现真正严重的缺陷。
- 对 AI 模型：针对代码审查的专项 Prompt 揭示了模型在结构化输出、多维度判断方面的改进空间，推动厂商优化对代码任务的理解能力。
- 对社区：LINUX DO 这类技术论坛的讨论沉淀了可复用的 Prompt 模板和经验，形成知识共享，降低其他开发者试用门槛。
长远来看，更聪明的代码审查 Prompt 有望让 AI 从“配角”逐步走向“初级审查者”角色，辅助团队提升代码质量，同时避免过度干扰。这也提示未来 AI 编程助手应内置此类审查模式，允许用户一键切换成“严肃审查”而非“随意分析”。