Communitygithub.com

mike1026915/performance-audit-skill

Claude Code と Cursor 向け静的パフォーマンス監査スキル — NestJS/Next.js/Prisma/Postgres アプリケーション内の N+1 クエリ、欠落インデックス、O(n²) コードを検出します。

performance-audit-skill とは?

このスキルは、Claude Code および Cursor 上で動作する静的パフォーマンス監査ツールです。NestJS + Next.js + Prisma + PostgreSQL のコードベースを解析し、パフォーマンスのアンチパターンを発見して重要度順に報告します。サーバの起動は不要で、ソースコードのスキャンによって動作するため、本番環境に影響を与えません。Prisma データアクセスの N+1 クエリや無制限の findMany、NestJS API のブロッキング同期呼び出し、Next.js/React の非効率的なバンドル、PostgreSQL スキーマの欠落インデックス、アルゴリズムの O(n²) パターンなど、5 つのレイヤーにわたる 35 のルールを備えています。各ルールは grep パターンに基づいてヒットを検出し、既知の偽陽性を除外した上で、ファイル:行番号、問題の理由、具体的な修正方法を含むマークダウンレポートを生成します。コードを変更することはなく、レポートの生成のみを行います。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mike1026915/performance-audit-skill/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 — 自由に使用、フォーク、ルールを自身のスタックに適応させてください。

関連スキル