Communitygithub.com

mike1026915/performance-audit-skill

适用于 Claude Code 和 Cursor 的静态性能审计技能,能够检测 NestJS/Next.js/Prisma/Postgres 应用中的 N+1 查询、缺失索引和 O(n²) 代码。

performance-audit-skill 是什么?

performance-audit-skill 是一个专为 Claude Code 和 Cursor 设计的静态代码审计工具,它通过扫描 NestJS + Next.js + Prisma + PostgreSQL 代码库来识别性能反模式,并生成一个按严重性排序的报告。该技能无需运行服务器,完全基于源代码分析,而非实时性能剖析。它包含了35条规则,覆盖 Prisma 数据访问、NestJS API、Next.js/React 前端、PostgreSQL 模式以及算法复杂度五个层面,能够发现诸如 N+1 查询、缺失索引、未分页列表、O(n²) 循环等常见性能问题。每条规则都映射到 grep 模式,但每个命中点都会在上下文中验证,过滤掉已知的误报(如有限查询、小规模固定集合等),且不会修改任何代码,只生成报告。支持自动检测技术栈,并跳过不适用的层面,Layer G(算法复杂度)则始终运行。报告以 Markdown 格式输出,按高、中、低三个等级排列,每项发现都附带文件位置、慢的原因和具体修复建议,超过20条发现时会额外保存到 `performance-audit-report.md` 文件中。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mike1026915/performance-audit-skill/tree/main

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

performance-audit

这是一个 Claude Code 技能(同时也是 Cursor 规则),用于对 NestJS + Next.js + Prisma + PostgreSQL 代码库进行静态性能审计,生成按严重性排序的报告。

无需运行服务器——它通过扫描源代码工作,而不是对实时应用进行性能剖析。

检测内容

5个层面的35条规则:

层面覆盖内容
D — Prisma / 数据访问N+1 查询、无限制的 findMany、过度获取、无限制的原始 SQL、事务中的慢操作、无限制的并行 I/O
A — NestJS API请求路径中的阻塞同步调用、未分页的列表接口、顺序的外部调用、无限制的内存缓存
F — Next.js / React未代码拆分的重量级客户端打包、不必要的 'use client'、客户端侧初始数据获取、搜索输入缺少防抖
S — PostgreSQL 模式外键/热门查询字段缺失索引、未锚定的 ILIKE 搜索、无法索引的向量列
G — 算法复杂度O(n²) 模式:循环中的重复线性查找、嵌套成对比较、循环内排序、扩展累加器复制、JSON.parse(JSON.stringify()) 克隆

每条规则都映射到一个 grep 模式,但每个命中点都会在上下文中验证后才被报告——已知的误报(有限查询、小规模固定集合、具有真实数据依赖的顺序 await 等)会被过滤掉。它永远不会修改代码——只生成报告。

安装

将此文件夹复制到你的项目中:

# Claude Code
cp -r performance-audit /path/to/your-project/.claude/skills/

# Cursor
cp performance-audit.mdc /path/to/your-project/.cursor/rules/

就这样——无需依赖,无需构建步骤。

使用

只需在任一工具中提问:

检查性能 查找慢查询 应用为什么慢 对 candidate 模块进行性能审计

你可以限定范围(例如“仅检查 packages/api 的性能”)或要求快速扫描(“快速性能检查”只运行高严重性规则)。

要求

  • 自动检测你的技术栈,并跳过不适用的层面(例如,没有 *.prisma 文件 → 层面 D 和 S 被跳过)。层面 G(算法复杂度)始终运行,因为它只涉及普通的 TS/JS,不依赖于特定框架。
  • 针对 NestJS + Next.js + Prisma + PostgreSQL 单体仓库进行了构建和调优,但 D/A/F/S 层面在部分技术栈上也能优雅降级(例如只有 NestJS 没有 Next.js),G 层面适用于任何 TS/JS 项目。

输出

一个按高 → 中 → 低排列的 Markdown 报告,每个发现都包含 文件:行号、慢的原因以及具体的修复建议:

# 性能审计 — 2026-07-09
已扫描层面:D, A, F, S, G(已跳过:无)

## 高
1. `src/foo.service.ts:123` — [D1] N+1:在 `.map(async)` 中每个候选者一次查询
   慢的原因:N 个候选者 → N+1 次往返;随数据量线性增长。
   修复:使用包含 `where: { id: { in: ids } }` 的单个 `findMany`,或使用 `include` 关联。

超过20个发现的报告还会保存到仓库根目录的 performance-audit-report.md 文件中。

许可

MIT — 随意使用、分支、并将规则适配到你自己的技术栈。

相关技能