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/
これだけで完了です — 依存関係もビルド手順も不要です。
使用方法
以下のように質問するだけです:
パフォーマンスをチェックして 遅いクエリを探して アプリが遅いのはなぜ? 候補モジュールのパフォーマンス監査を実行して
スコープを指定することもできます(「packages/api のみのパフォーマンスをチェックして」)し、簡易チェックを依頼することもできます(「クイックパフォーマンスチェック」は High 重要度のルールのみを実行します)。
要件
- スタックを自動検出し、該当しないレイヤーはスキップします(例:
*.prismaファイルがない場合 → レイヤー D と S はスキップされます)。レイヤー G(アルゴリズムの複雑性)はフレームワーク固有ではなくプレーンな TS/JS であるため、常に実行されます。 - NestJS + Next.js + Prisma + PostgreSQL のモノレポを対象に構築・調整されていますが、D/A/F/S レイヤーは部分的なスタックでも適切に動作します(例: Next.js なしの NestJS)。レイヤー G は任意の TS/JS プロジェクトで動作します。
出力
High → Medium → Low の順にランク付けされたマークダウンレポート。各発見には ファイル:行番号、遅い理由、具体的な修正方法が含まれます:
# パフォーマンス監査 — 2026-07-09
スキャンしたレイヤー: D, A, F, S, G(スキップ: なし)
## High
1. `src/foo.service.ts:123` — [D1] N+1: `.map(async)` 内で候補ごとに 1 つのクエリ
遅い理由: N 個の候補 → N+1 回のラウンドトリップ。データに応じて線形に増加します。
修正方法: `where: { id: { in: ids } }` を指定した単一の `findMany`、またはリレーションを `include` してください。
発見が 20 件を超えるレポートは、リポジトリルートに performance-audit-report.md として保存されます。
ライセンス
MIT — 自由に使用、フォーク、ルールを自身のスタックに適応させてください。