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 — 随意使用、分支、并将规则适配到你自己的技术栈。