WinMD API Search

このスキルは、任意の機能に対して適切な Windows API を見つけ、その完全な詳細を取得するのに役立ちます。以下のすべての WinMD メタデータのローカルキャッシュを検索します:

• Windows Platform SDK — すべての Windows.* WinRT API (常に利用可能、復元不要)
• WinAppSDK / WinUI — キャッシュジェネレータのベースラインとしてバンドル (常に利用可能、復元不要)
• NuGet パッケージ — .winmd ファイルを含む復元されたプロジェクト内の任意の追加パッケージ
• プロジェクト出力 WinMD — ビルド出力として .winmd を生成するクラスライブラリ (C++/WinRT、C#)

復元やビルドなしのクリーンクローン時でも、Platform SDK + WinAppSDK の完全なカバレッジが得られます。

このスキルを使用する場合

• ユーザーが機能を構築したいとき、その機能を提供する API を見つける必要がある
• ユーザーが「X をどうやるのか?」と尋ねる場合 (X がカメラ、ファイル、通知、センサー、AI など のプラットフォーム機能を含む)
• コードを書く前に、型の正確なメソッド、プロパティ、イベント、または列挙値が必要
• UI またはシステムタスク用にどのコントロール、クラス、またはインターフェースを使用するかが不明確

前提条件

• .NET SDK 8.0 以降 — キャッシュジェネレータのビルドに必要。dotnet.microsoft.com からインストールしてください (利用できない場合)。

キャッシュセットアップ (初回使用前に必須)

すべてのクエリおよび検索コマンドは、ローカル JSON キャッシュから読み込みます。任意のクエリを実行する前に、キャッシュを生成する必要があります。

# リポジトリ内のすべてのプロジェクト (初回実行時に推奨)
.\.github\skills\winmd-api-search\scripts\Update-WinMdCache.ps1

# 単一プロジェクト
.\.github\skills\winmd-api-search\scripts\Update-WinMdCache.ps1 -ProjectDir <project-folder>

ベースラインカバレッジ (Platform SDK + WinAppSDK) にはプロジェクトの復元やビルドは不要です。追加の NuGet パッケージの場合、プロジェクトは dotnet restore (生成される project.assets.json) または packages.config ファイルが必要です。

キャッシュは Generated Files\winmd-cache\ に格納され、パッケージ+バージョンごとに重複排除されます。

インデックスされるもの

ソース	利用可能な時期
Windows Platform SDK	常に (ローカル SDK インストールから読み込む)
WinAppSDK (最新)	常に (キャッシュジェネレータにベースラインとしてバンドル)
WinAppSDK Runtime	システムにインストールされている場合 (Get-AppxPackage で検出)
プロジェクト NuGet パッケージ	dotnet restore 後または packages.config で
プロジェクト出力 .winmd	プロジェクトビルド後 (WinMD を生成するクラスライブラリ)

注: このキャッシュディレクトリは .gitignore に含まれるべき — 生成ファイルであり、ソースではありません。

使い方

状況に合わせたパスを選択:

---

発見 — 「どの API を使うべきかわからない」

ユーザーが独自の言葉で機能を説明します。適切な API を見つける必要があります。

0. キャッシュが存在することを確認

キャッシュがまだ生成されていない場合、先に Update-WinMdCache.ps1 を実行してください — 上の キャッシュセットアップ を参照。

1. ユーザー言語 → 検索キーワードに翻訳

ユーザーの日常言語をプログラミング用語にマッピング。複数のバリエーションを試す:

ユーザーが言う	試すべき検索キーワード (順序)
「写真を撮る」	camera, capture, photo, MediaCapture
「ディスクから読み込む」	file open, picker, FileOpen, StorageFile
「何が入っているか説明する」	image description, Vision, Recognition
「ポップアップを表示する」	dialog, flyout, popup, ContentDialog
「ドラッグアンドドロップ」	drag, drop, DragDrop
「設定を保存する」	settings, ApplicationData, LocalSettings

簡単な日常用語から始めてください。結果が弱い、または無関係な場合は、より技術的なバリエーションを試してください。

2. 検索を実行

.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action search -Query "<keyword>"

これは上位マッチングタイプを持つランク付きネームスペースと JSON ファイルパス を返します。

結果が 低いスコア (60 未満) または無関係 の場合、オンラインドキュメント検索にフォールバック:

1. Web 検索を使用して Microsoft Learn で適切な API を見つけます。例:
   • site:learn.microsoft.com/uwp/api <capability keywords> (Windows.* API の場合)
   • site:learn.microsoft.com/windows/windows-app-sdk/api/winrt <capability keywords> (Microsoft.* WinAppSDK API の場合)
2. ドキュメントページを読んで、ユーザーの要件に合う型を特定します。
3. 型名がわかったら、戻ってきて -Action members または -Action enums を使用して正確なローカル署名を取得します。

3. JSON を読んで適切な API を選択

上位結果のパスにあるファイルを読みます。JSON にはそのネームスペース内のすべての型が含まれます — 完全なメンバー、署名、パラメータ、戻り型、列挙値。

読んでユーザーの要件に合う型とメンバーを決定します。

4. 公式ドキュメントで背景を調べる

キャッシュには署名のみが含まれます — 説明や使用法ガイダンスはありません。説明、例、備考については、Microsoft Learn で型を検索:

ネームスペース プレフィックス	ドキュメント ベース URL
Windows.*	https://learn.microsoft.com/uwp/api/{fully.qualified.typename}
Microsoft.* (WinAppSDK)	https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/{fully.qualified.typename}

例: Microsoft.UI.Xaml.Controls.NavigationView は以下にマップ: https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.navigationview

5. API 知識を使用して回答またはコードを記述

---

ルックアップ — 「API を知っています、詳細を表示してください」

型またはネームスペース名を既に知っている (または疑っている)。直接実行:

# 既知の型のすべてのメンバーを取得
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action members -TypeName "Microsoft.UI.Xaml.Controls.NavigationView"

# 列挙値を取得
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action enums -TypeName "Microsoft.UI.Xaml.Visibility"

# ネームスペース内のすべての型をリスト
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action types -Namespace "Microsoft.UI.Xaml.Controls"

# ネームスペースを参照
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action namespaces -Filter "Microsoft.UI"

-Action members が表示する以上の完全な詳細が必要な場合は、-Action search を使用して JSON ファイルパスを取得してから、JSON ファイルを直接読みます。

---

その他のコマンド

# キャッシュされたプロジェクトをリスト
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action projects

# プロジェクトのパッケージをリスト
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action packages

# 統計を表示
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action stats

プロジェクトが 1 つだけキャッシュされている場合、-Project は自動選択されます。 複数のプロジェクトが存在する場合、-Project <name> を追加してください (-Action projects で利用可能な名前を確認)。 スキャンモードでは、マニフェスト名に短いハッシュサフィックスが含まれて衝突を避けます。曖昧性がない場合は、サフィックスなしのベースプロジェクト名を渡せます。

検索スコアリング

検索はクエリに対して型名とメンバー名をランク付けします:

スコア	マッチタイプ	例
100	完全一致	Button → Button
80	開始位置が一致	Navigation → NavigationView
60	含む	Dialog → ContentDialog
50	PascalCase イニシャル	ASB → AutoSuggestBox
40	複数キーワード AND	navigation item → NavigationViewItem
20	曖昧な文字マッチ	NavVw → NavigationView

結果はネームスペースでグループ化されます。スコアが高いネームスペースが最初に表示されます。

トラブルシューティング

問題	修正
「キャッシュが見つかりません」	Update-WinMdCache.ps1 を実行
「複数のプロジェクトがキャッシュされています」	-Project <name> を追加
「ネームスペースが見つかりません」	-Action namespaces を使用して利用可能なものをリスト
「型が見つかりません」	完全修飾名を使用 (例: Microsoft.UI.Xaml.Controls.Button)
NuGet 更新後に古い	Update-WinMdCache.ps1 を再実行
キャッシュが git 履歴に	Generated Files/ を .gitignore に追加

リファレンス

• Windows Platform SDK API リファレンス — Windows.* ネームスペースのドキュメント
• Windows App SDK API リファレンス — Microsoft.* WinAppSDK ネームスペースのドキュメント