performance-test-jmeter について
JMeterを使用中、またはJMeter向けの計画を必要とするチーム向けの性能テストスキルです。設定やレポートだけで成功と判断せず、実測スループット、データ消費、アサーション、しきい値、CI結果を確認します。
主な機能
- 01JMeter、JDK、プラグイン環境の確認
- 02JMX構造と変数設定の点検
- 03スレッド、タイマー、目標RPSの計画
- 04CSVデータ消費設定の記録
- 05アサーション、レイテンシ、エラー、CIの個別確認
活用シーン
- 01JMeterプロジェクトの性能テスト計画
- 02スレッド数と実測スループットの関係確認
- 03分散テストのデータと負荷配分の点検
- 04JTL、業務アサーション、CIゲートの評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/performance-test-jmeterを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamldomain-method-regression.yamledge-incomplete-input.yamledge-scope-boundary.yamlevals/fixtures/check_domain_decisions.pycheck-domain-decisions.shdomain-oracle.jsonevals/fixtures/jmx/business-oracle.jmxcheck_jtl.pyorders.csvREADME.mdexamples/sample-context.mdoutput-templates/template-markdown.mdprompts/performance-test-jmeter.mdreferences/domain-decision-example.mdframework-spec.mdsetup-and-ci.mdscripts/run-tests.sh詳細
JMeter パフォーマンステスト（EN）
中国語版： 対応する中国語のスキルを参照してください。
使用するタイミング
- JMeter のパフォーマンステストワークフローで利用する成果物が必要な場合。
- プロジェクトですでに JMeter を使用している場合、または JMeter ですぐに使える計画を求めている場合。
出力形式のオプション
別の形式が明示的に指定されていない限り、デフォルトは Markdown です。
使用方法
prompts/performance-test-jmeter.mdを開き、メインのプロンプトとして使用します。- 対象範囲、環境、制約、リスク、依存関係、期待する成果物など、実際のプロジェクトのコンテキストを追加します。
- 入力が不完全な場合は、実用的な初版を返し、不足情報と前提条件を明示します。
参考ファイル
-
ドメインの結果、妥当な制御項目、証拠の不足を調整する際は、references/domain-decision-example.md を参照してください。サニタイズ済みの入力、項目ごとのオラクル、再現可能な計算が記載されています。
-
prompts/performance-test-jmeter.md：このスキルのメインプロンプトです。 -
references/framework-spec.md：ツール固有の構造とカバレッジに関する注意事項です。 -
references/setup-and-ci.md：セットアップ、実行、CI に関する注意事項です。 -
examples/sample-context.md：リクエストコンテキストのサンプルです。 -
scripts/run-tests.sh：ローカル実行用の軽量なエントリーポイントです。
ドメイン実行の要点
- プロジェクトの JMeter／JDK／プラグインと JMX のバージョンを確認します。TestPlan／ThreadGroup／Sampler と隣接する hashTree の構造、変数、プロパティを確認します。XML を解析できても、それによって証明されるのは構造のみであり、実行や SLO の達成ではありません。
- 標準の ThreadGroup では、クローズドループのスレッドが制御されます。目標 RPS を達成するには、宣言済みの思考時間／タイマー、スループット制御、またはインストール済みの到着率プラグインが必要です。スレッド数から RPS を推測するのではなく、達成したスループット／件数を検証してください。
- CSV のパス、エンコーディング、列、共有設定、リサイクル／stopThread 設定、スレッド／ループごとの消費状況を記録します。分散実行では、各インジェクターのデータ／プラグイン／ネットワークと負荷の割り当てを確認します。
- 許可された環境では非 GUI の実行方法を使用し、JTL／ログを保持します。ビジネス上のアサーション、レイテンシ／エラーのゲート、CI への結果反映をそれぞれ確認します。しきい値がない場合は UNKNOWN とします。HTML レポートや終了コード 0 で、失敗したサンプルを隠してはいけません。
よくある落とし穴
- 対象範囲が曖昧で、コンテキストもない状態では使用しないでください。
- すべての領域を同じ重要度として扱わないでください。
- 前提条件や不足情報を省略しないでください。
ベストプラクティス
-
プロンプトファイルを起点にし、重要なコンテキストだけを追加します。
-
リスクに基づいた、実行可能な出力にします。
-
リクエストが不完全な場合は、実用的な初版を返し、不足事項を明示します。
-
DSL／JMX アセットとデータ消費の境界を確認するには、evals/fixtures/jmx/README.md を参照してください。ローカルの例はアセットの調整に役立ちますが、プロジェクトのゲートがなければ受け入れ可否を確定できません。