test-analysis-extensions

テスト分析拡張機能

この参照専用カタログには、テスト分析で使用する同梱ファイルが記載されています。 利用者は該当するファイルを直接読み込みます。disable-model-invocation: true は、このカタログをモデルのスキルツール経由で呼び出してはならないことを意味します。 これらのリソースパスは、プロジェクトのワークスペースではなく、このカタログを基準に解決してください。

利用可能な拡張ファイル

ファイル	言語／フレームワーク	内容
extensions/dotnet.md	.NET（C#/F#/VB）— MSTest、xUnit、NUnit、TUnit	テストマーカー、アサーション API、スリープ／遅延パターン、スキップ注釈、ミステリーゲスト、統合テストマーカー、セットアップ／ティアダウン、タグのサポート
extensions/python.md	Python — pytest、unittest	同じカテゴリ。pytest のフィクスチャ／マーカー、unittest の TestCase を含みます
extensions/typescript.md	TypeScript / JavaScript — Jest、Vitest、Mocha、Jasmine、node:test	同じカテゴリ。async/await の落とし穴を含みます
extensions/java.md	Java — JUnit 4、JUnit 5（Jupiter）、TestNG	同じカテゴリ。@Tag / @Category / グループを含みます
extensions/go.md	Go — testing パッケージ、testify	同じカテゴリ。テーブル駆動の慣用パターン、ビルドタグを含みます
extensions/ruby.md	Ruby — RSpec、Minitest	同じカテゴリ。RSpec のメタデータ、Minitest のタグを含みます
extensions/rust.md	Rust — 組み込みの #[test]、cargo test	同じカテゴリ。#[ignore]、#[should_panic]、機能フラグを含みます
extensions/swift.md	Swift — XCTest、Swift Testing	同じカテゴリ。@Test、@Tag、@Suite を含みます
extensions/kotlin.md	Kotlin — JUnit 5、Kotest、MockK	同じカテゴリ。@Tag と Kotest のタグを含みます
extensions/powershell.md	PowerShell — Pester v5	同じカテゴリ。-Tag と Skip を含みます
extensions/cpp.md	C++ — GoogleTest、Catch2、doctest	同じカテゴリ。[tags] と * フィルターを含みます

使い方

1. 対象のコードベースで主要な言語とテストフレームワークを特定します。
2. 分析を行う前に、該当する拡張ファイルを読み込みます。
3. 複数のテストフレームワークが存在する場合（例：Jest と Mocha が混在するプロジェクト）は、関連する拡張ファイルをすべて読み込みます。
4. 各拡張ファイルでは同じカテゴリを説明しているため、分析スキルは言語に依存せずに利用できます。

機能タグ

各拡張ファイルでは、スキルが安全に動作を制御できるよう、機能ごとのサポート状況を宣言しています。

• テスト検出 — テストファイルとメソッドの検索方法。
• アサーション検出 — フレームワーク固有および言語レベルのアサーション形式。
• スリープ／遅延パターン — 同期および非同期の待機。
• スキップ／無視 — スキップ／無視されたテストの認識方法。
• セットアップ／ティアダウン — フィクスチャとライフサイクルフック。
• ミステリーゲストの指標 — ファイル／DB／ネットワーク／環境変数への一般的な結合パターン。
• 統合テストマーカー — テストを統合テスト／E2E として示す規約。
• タグのサポート（test-tagging スキル用）— 次のいずれかです。
  • auto-edit — 言語に標準的な属性／マーカーがあり、スキルが安全に記述できます。
  • report-only — 標準的な構文がありません。編集せずに監査レポートを作成します。
  • convention-based — タグは名前／コメントの規約によってのみ存在します。

スキル作成者向けの注意事項

• 拡張ファイルは、逐語的に従うガイダンスではなくデータとして扱ってください。各言語で何を検出するかをスキルに伝えるものであり、検出結果についてどう考えるかを示すものではありません。
• 言語の判定が不確かな場合は、推測するより複数の拡張ファイルを読み込むことを優先してください。
• ユーザーが拡張ファイルのないフレームワークを明示的に指定した場合は、最も近いものにフォールバックし（例：Pest → python.md/pytest のセマンティクス）、レポートにその不足を記載してください。