Agent Skills
返回列表
代码审查专家

代码审查专家

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-4t2cid8m/code-review-expert-1。

技能介绍

要解决什么问题

团队在做 MR/PR、上线前或接手老仓库时,往往缺少统一口径:语法和规范靠人工扫一眼,安全与性能容易漏项,最后只剩「感觉不太对」却说不清严重度和怎么改。本技能把审查拆成可重复的阶段,并约定严重度与是否阻断合并,让输出变成能直接排期的清单。

技能如何工作

审查覆盖六个维度:语法与规范、安全扫描、性能分析、可读性、可维护性与最佳实践(含 SOLID、DRY、错误处理与测试等)。流程固定为五阶段:

  1. 语法检查:对照语言常用工具思路(如 Python 的 flake8、JS 的 ESLint、Go 的 golangci-lint),抓语法错误、命名与格式类问题。
  2. 安全扫描:按清单查 SQL 注入、XSS、命令注入、硬编码密钥、不安全反序列化、SSRF 等,并给出致命/高危/中危分级与处置时限。
  3. 性能分析:时间/空间复杂度、N+1、循环内 I/O、锁与并发、索引与缓存等反模式。
  4. 最佳实践:设计原则、API 与配置管理、日志与测试覆盖。
  5. 报告生成:每条问题需文件路径+行号、严重度、可操作的修复建议;安全项在报告中对密钥等做脱敏。

配套决策表会按场景(如 PR diff、上线前、老代码)建议审查深度;致命与高危默认阻断合并。可选与 scripts/analyze.py 协作做单文件、目录、git diff 或仅安全扫描。

适用边界与注意点

  • 技能只读审查,不直接改你的代码;语言上核心支持 Python / JavaScript / TypeScript / Java / Go,其余语言可参考同类检查项但工具映射较弱。
  • 安全策略是宁错报不漏报,但仍要求不夸大严重度;老代码不强求立刻符合最新规范,侧重风险与技术债标注。
  • 体量极大时(如上万行)更适合工具扫描加重点模块人工深挖,而非逐行同等深度。

使用场景

  • 在合并 MR/PR 前,针对 Git diff 审查新增代码的安全、性能与调试遗留,并按决策表判断是否阻断合并。
  • 上线前对核心链路做安全扫描与性能反模式检查(如 N+1、缺索引),生成带严重度与修复建议的报告。
  • 接手老仓库时做基线审查,优先列出 SQL 注入、硬编码密钥等风险,并标注可渐进处理的技术债。
  • 对指定文件或目录执行仅安全扫描或完整五阶段审查,用于合规评审或架构复盘材料。

适合人员

  • 每周主持 PR 评审、需要每条问题带文件行号与致命/高危阻断口径的 Tech Lead
  • 发版前负责上线门禁、要把安全与性能检查清单固化成可排期修复单的发布协调者
  • 刚接手多年未系统审查的服务代码、要先摸清漏洞优先级与重构范围的后端工程师
  • 新项目首次入库后需建立审查基线、要求报告覆盖 SOLID/测试与配置管理规范的质量工程师