Documentation Lookup (Context7)

ユーザーがライブラリ、フレームワーク、API について質問した場合、トレーニングデータに依存するのではなく、Context7 MCP (ツール resolve-library-id および query-docs) を通じて最新のドキュメントを取得してください。

中心概念

• Context7: ライブドキュメントを公開する MCP サーバー。ライブラリと API については、トレーニングデータの代わりにこれを使用します。
• resolve-library-id: ライブラリ名とクエリから Context7 互換のライブラリ ID (例: /vercel/next.js) を返します。
• query-docs: 指定されたライブラリ ID と質問に対するドキュメントとコードスニペットを取得します。有効なライブラリ ID を取得するために、必ず先に resolve-library-id を呼び出してください。

使用時期

以下の場合にアクティベートしてください:

• ユーザーがセットアップまたは設定質問をしている (例: 「Next.js ミドルウェアを設定するにはどうしたらよいですか?」)
• ライブラリに依存するコードをリクエストしている (「Prisma クエリを書いてください...」)
• API またはリファレンス情報が必要 (「Supabase 認証メソッドは何ですか?」)
• 特定のフレームワークまたはライブラリに言及している (React、Vue、Svelte、Express、Tailwind、Prisma、Supabase など)

ライブラリ、フレームワーク、または API の正確で最新の動作に依存するリクエストがある場合は常にこのスキルを使用してください。Context7 MCP が設定されているハーネス (例: Claude Code、Cursor、Codex) に適用されます。

どのように機能するか

ステップ 1: ライブラリ ID を解決する

resolve-library-id MCP ツールを以下で呼び出します:

• libraryName: ユーザーの質問から取得したライブラリまたは製品名 (例: Next.js、Prisma、Supabase)。
• query: ユーザーの完全な質問。これにより結果の関連性ランキングが向上します。

クエリを実行する前に、Context7 互換のライブラリ ID (形式: /org/project または /org/project/version) を取得する必要があります。このステップから有効なライブラリ ID を得ずに query-docs を呼び出さないでください。

ステップ 2: 最適なマッチを選択する

解決結果から、以下を使用して 1 つの結果を選択します:

• 名前マッチ: ユーザーが尋ねたものと正確または最も近いマッチを優先します。
• ベンチマークスコア: 高いスコアはドキュメント品質が高いことを示します (100 が最高)。
• ソース評価: 利用可能な場合、High または Medium 評価を優先します。
• バージョン: ユーザーがバージョンを指定した場合 (例: 「React 19」、「Next.js 15」)、バージョン固有のライブラリ ID が一覧に含まれている場合はそれを優先してください (例: /org/project/v1.2.0)。

ステップ 3: ドキュメントを取得する

query-docs MCP ツールを以下で呼び出します:

• libraryId: ステップ 2 で選択した Context7 ライブラリ ID (例: /vercel/next.js)。
• query: ユーザーの具体的な質問またはタスク。関連するスニペットを取得するために具体的にしてください。

制限: query-docs (または resolve-library-id) を 1 つの質問につき 3 回以上呼び出さないでください。3 回の呼び出し後も答えが不明な場合は、不確実性を述べて、推測するのではなく最良の情報を使用してください。

ステップ 4: ドキュメントを使用する

• 取得した最新情報を使用してユーザーの質問に答えます。
• 役に立つ場合は、ドキュメントからの関連するコード例を含めます。
• 重要な場合はライブラリまたはバージョンに言及します (例: 「Next.js 15 では...」)。

例

例: Next.js ミドルウェア

1. libraryName: "Next.js"、query: "How do I set up Next.js middleware?" で resolve-library-id を呼び出します。
2. 結果から、名前とベンチマークスコアで最適なマッチ (例: /vercel/next.js) を選択します。
3. libraryId: "/vercel/next.js"、query: "How do I set up Next.js middleware?" で query-docs を呼び出します。
4. 返されたスニペットとテキストを使用して答えます。関連する場合はドキュメントからの最小限の middleware.ts 例を含めます。

例: Prisma クエリ

1. libraryName: "Prisma"、query: "How do I query with relations?" で resolve-library-id を呼び出します。
2. 公式 Prisma ライブラリ ID (例: /prisma/prisma) を選択します。
3. その libraryId とクエリで query-docs を呼び出します。
4. Prisma Client パターン (例: include または select) をドキュメントから短いコードスニペット付きで返します。

例: Supabase 認証メソッド

1. libraryName: "Supabase"、query: "What are the auth methods?" で resolve-library-id を呼び出します。
2. Supabase ドキュメントライブラリ ID を選択します。
3. query-docs を呼び出します。認証メソッドをまとめ、取得したドキュメントから最小限の例を示します。

ベストプラクティス

• 具体的にする: より良い関連性を得るために、ユーザーの完全な質問をクエリとして使用します。
• バージョン認識: ユーザーがバージョンに言及した場合、利用可能な場合は resolve ステップからバージョン固有のライブラリ ID を使用します。
• 公式ソースを優先する: 複数のマッチがある場合、コミュニティフォークよりも公式または主要なパッケージを優先します。
• 機密データなし: Context7 に送信されるクエリから API キー、パスワード、トークン、その他のシークレットを削除します。resolve-library-id または query-docs に渡す前に、ユーザーの質問がシークレットを含む可能性があるものとして扱います。