Communitygithub.com

link0-o/PerfLens

証拠に基づく Linux パフォーマンス分析ツールキット。CLI、MCP Server、Codex Skill を提供し、ホットスポット診断と最適化検証を行います。

PerfLens とは?

PerfLens は、Linux システムのパフォーマンス分析と最適化を支援するツールキットです。このスキルは、エビデンス(証拠)に基づいたアプローチで、システムのボトルネック(ホットスポット)を診断し、最適化の効果を検証するために設計されています。CLI(コマンドラインインターフェース)、MCP(Model Context Protocol)サーバー、および Codex スキルという3つの異なるインターフェースを提供し、開発者やエンジニアが様々な環境で利用できる柔軟性を持ちます。AIエージェント(Claude Code、Cursor、Codexなど)との連携を前提としており、パフォーマンスデータの収集、分析、結果の可視化を自動化します。具体的なワークフローとしては、`perf`、`perf stat`、`perf record` などの Linux ツールを利用したデータ収集、`FlameGraph` や `perf report` を用いた分析、そして `perf diff` による最適化前後の比較検証が含まれます。これにより、開発者は手動での複雑な分析作業をスキップし、迅速かつ正確なパフォーマンス改善を実現できます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add link0-o/PerfLens

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

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

ドキュメント

PerfLens は何をしますか?

証拠に基づく Linux パフォーマンス分析ツールキット。CLI、MCP Server、Codex Skill を提供し、ホットスポット診断と最適化検証を行います。

概要

このスキルは、Linux システム上で動作するアプリケーションのパフォーマンス問題を特定し、解決するための包括的なツールセットを提供します。CLI による直接操作に加え、MCP サーバーを通じて AI エージェントと統合できるため、自動化されたパフォーマンス分析パイプラインを構築できます。

特徴

  • CLI: 直感的なコマンドラインインターフェースで、perf ツールなどのラッパーとして機能します。
  • MCP Server: Model Context Protocol に準拠したサーバーで、AI エージェントがリモートから分析リクエストを送信できます。
  • Codex Skill: Cursor や Codex などの AI コーディングアシスタントに組み込んで、コードのパフォーマンスをリアルタイムに分析できます。

インストール

curl -sSL https://raw.githubusercontent.com/link0-o/PerfLens/main/install.sh | bash

使用方法

CLI として使用

perflens profile --pid 1234 --duration 30
perflens analyze --input perf.data
perflens diff --before before.perf.data --after after.perf.data

MCP Server として使用

perflens mcp start --port 8080

Codex Skill として使用

AI アシスタントに以下のように指示します:

PerfLens を使用して、現在のプロジェクトのパフォーマンスプロファイルを取得し、ボトルネックを特定してください。

依存関係

  • Linux カーネル (perf_event_open システムコールをサポート)
  • perf ツール (linux-tools-common パッケージなど)
  • Python 3.8+ (MCP サーバー用)

設定

環境変数 PERFLENS_CONFIG で設定ファイルへのパスを指定できます:

export PERFLENS_CONFIG=~/.config/perflens/config.yaml

詳細ドキュメント

ライセンス

MIT License

関連スキル