Communitygithub.com

ZJtoast/kernel-profiler-skill

CUDA および Triton カーネル向けの Nsight Compute を用いたカーネル専用プロファイリングワークフロー。標準化されたレポート、視覚的分析、ベンダーポータブルなアダプタを提供します。

kernel-profiler-skill とは?

このスキルは、CUDA および Triton で記述された GPU カーネルのプロファイリングに特化したワークフローを提供します。NVIDIA Nsight Compute を利用してカーネルのパフォーマンスを詳細に分析し、標準化されたレポートを生成することで、結果の比較や共有を容易にします。さらに、視覚的分析機能により、ボトルネックの特定や最適化の優先順位付けを直感的に行えます。ベンダーポータブルなアダプタ設計により、NVIDIA GPU 以外のハードウェアにも将来対応可能な拡張性を持ち、AI エージェントや開発者が効率的にカーネル性能を最適化するための基盤を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add ZJtoast/kernel-profiler-skill

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

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

ドキュメント

kernel-profiler-skill は何をしますか?

CUDA および Triton カーネル向けの Nsight Compute を用いたカーネル専用プロファイリングワークフロー。標準化されたレポート、視覚的分析、ベンダーポータブルなアダプタを提供します。

概要

このスキルは、GPU カーネルのパフォーマンスプロファイリングに特化したワークフローを提供します。対象は CUDA カーネルと Triton カーネルで、NVIDIA Nsight Compute を使用して詳細なプロファイリングデータを取得します。取得したデータは標準化されたレポート形式で出力され、視覚的な分析ツールと組み合わせて活用できます。また、ベンダーポータブルなアダプタを備えており、将来のハードウェア変更にも柔軟に対応可能です。

前提条件

  • NVIDIA GPU と最新のドライバ
  • NVIDIA Nsight Compute CLI (ncu) がインストールされていること
  • Python 3.8 以降
  • Triton カーネルをプロファイリングする場合は、Triton がインストールされていること

インストール

git clone https://github.com/ZJtoast/kernel-profiler-skill.git
cd kernel-profiler-skill
pip install -r requirements.txt

使用方法

CUDA カーネルのプロファイリング

python profile_cuda.py --kernel my_kernel.cu --output reports/

Triton カーネルのプロファイリング

python profile_triton.py --kernel my_triton_kernel.py --output reports/

レポートの生成

python generate_report.py --input reports/ --format html

出力形式

  • reports/: プロファイリング結果が格納されるディレクトリ
  • reports/*.json: 構造化データ(機械処理向け)
  • reports/*.csv: 表形式データ
  • reports/*.html: 視覚化されたレポート

ベンダーアダプタ

ベンダーポータブルなアダプタを使用することで、将来の GPU アーキテクチャや他ベンダーのハードウェアにも対応できます。アダプタは adapters/ ディレクトリに配置されています。

ライセンス

MIT


## 貢献

プルリクエストは歓迎します。大きな変更を加える場合は、まず issue を開いて議論してください。

## サポート

問題が発生した場合は、GitHub Issues に報告してください。

関連スキル