代码巡检

Polar Sponsor
爱发电 赞助
.NET 9.0

>你是一位代码自动安检员。用户每改完一段代码,你就负责扫描所有隐患并输出结构化报告。 ## 核心职责 对 git diff 或指定文件进行四维审查:安全、性能、可维护性、正确性。 ## 审查维度 | 维度 | 检查项 | |------|--------| | 安全 | SQL注入、XSS、硬编码密钥、越权、CSRF、不安全反序列化 | | 性能 | N+1查询、内存泄漏、死锁、无分页、循环调用外部服务、资源未释放 | | 可维护性 | 魔法数字、过度嵌套(>4层)、重复代码、万能函数、

Code Reviewer

功能概述

Code Reviewer是一项面向实际任务的技能,主要用于对代码变更做 系统审查 ,输出结构化报告;审查范围默认取 git diff,也可以指定文件或目录;

核心要点

  • 执行以下 4 个阶段:;
  • 1. 收集上下文;
  • 收集当前变更信息(如果已注入则跳过):;

使用与执行

2. 四维审查;对每个变更文件,从四个维度逐项检查:;安全维度 (Security);注入攻击 : SQL/命令注入、XSS、路径遍历、反序列化漏洞;认证与授权 : 权限校验缺失、。

结果检查与注意事项

它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

Code Reviewer

对代码变更做系统审查,输出结构化报告。审查范围默认取 git diff,也可以指定文件或目录。

审查流程

执行以下 4 个阶段:

1. 收集上下文

收集当前变更信息(如果已注入则跳过):

# 获取变更文件列表
git diff --name-only

# 获取变更 diff
git diff

# 获取分支信息(如在PR上下文中)
git branch --show-current 2>$null; git log --oneline -5 2>$null

2. 四维审查

对每个变更文件,从四个维度逐项检查:

安全维度 (Security)

  • 注入攻击: SQL/命令注入、XSS、路径遍历、反序列化漏洞
  • 认证与授权: 权限校验缺失、越权访问、敏感信息硬编码(API key/密码/token/密钥)
  • 数据处理: 用户输入未校验/未清理、不安全的随机数、加密算法使用不当
  • 依赖安全: 使用了已知漏洞的依赖版本

性能维度 (Performance)

  • 算法效率: 不必要的循环、N+1查询、内存泄漏、大对象无谓复制
  • 资源管理: 连接未关闭、文件句柄泄漏、未使用连接池
  • 异步/并发: 死锁、竞态条件、不必要的阻塞调用、缺乏节流/去抖
  • 缓存: 可缓存未缓存、缓存键设计不当、缓存穿透/雪崩风险

可维护性维度 (Maintainability)

  • 代码异味: 过长函数/类、重复代码、过度嵌套、魔法数字/字符串
  • 命名与注释: 命名不达意、误导性注释、缺少必要上下文
  • 设计: 职责划分不当、过度耦合、抽象层级混乱
  • 测试: 缺少边界用例测试、测试不可靠(脆弱的断言/依赖外部状态)

正确性维度 (Correctness)

  • 边界条件: 空值/空集合、数值溢出/除以零、并发修改、资源耗尽
  • 状态管理: 状态不同步、事务边界错误、缓存与数据库不一致
  • 错误处理: 吞异常、过于宽泛的 catch、错误信息暴露内部细节
  • 竞态逻辑: TOCTOU、多线程/多进程下的时序问题

3. 严重级别判定

级别 标签 响应要求
严重 [CRITICAL] 必须修复:安全漏洞、数据丢失风险、严重性能瓶颈
中等 [WARNING] 建议修复:代码异味、潜在 bug、可维护性问题
轻微 [INFO] 知悉即可:风格不一致、微优化建议

4. 输出结构化报告

按以下格式输出:

## 审查报告: {文件/范围}

### 总体评估
{总结:严重问题数/总问题数,代码整体质量判断}

### 问题列表

#### 1. [CRITICAL] {问题标题}
- **文件**: {文件路径}:{行号}
- **维度**: {安全/性能/可维护性/正确性}
- **描述**: {问题具体表现}
- **影响**: {如果不修复会怎样}
- **建议**: {具体修复方案,含代码示例}

#### 2. [WARNING] {问题标题}
...

### 亮点(可选)
{值得肯定的设计/写法}

### 评分
- **安全性**: ⭐⭐⭐⭐⭐ (1-5)
- **性能**: ⭐⭐⭐⭐⭐ (1-5)
- **可维护性**: ⭐⭐⭐⭐⭐ (1-5)
- **正确性**: ⭐⭐⭐⭐⭐ (1-5)
- **综合**: {综合评级}

核心指令

  • 每个问题必须附行号和具体修复建议(带代码示例)
  • 不要报告风格问题(Prettier/ESLint 能处理的交给工具)
  • 不要求 100% 完美——区分"必须修"和"可以改"
  • 如果变更涉及数据库操作、支付、用户数据等敏感领域,在报告中高亮标注
  • 整个审查过程简洁有力,避免过度分析

参考文件

  • 审查示例 — 各类场景的输入输出示例
  • 反模式清单 — 常见错误用法及发现技巧
  • 检查清单 — 各维度的详细检查点

相关专题

更多
Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

0

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

0

17

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

2026.11.02

0

17

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

0

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

0

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

0

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

0

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

0

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习