mcpField
A
ai-sdk

ai-sdk

github.com/laguagu開発71143 回インストール1 日前に更新
リポジトリ

ai-sdk について

Vercel AI SDK を使う開発者向けのドキュメント案内スキルです。導入済みパッケージのバージョンを確認し、実装前に対応する API と資料を探してバージョン不整合を抑えます。

主な機能

  1. 01導入済み SDK バージョンの特定
  2. 02メジャーバージョン別の案内
  3. 03ローカル文書と型定義の検索
  4. 04対応バージョンの API 参照を検索
  5. 05プロバイダーのモデル設定を確認

活用シーン

  1. 01AI SDK の更新や移行の準備
  2. 02導入済みメジャーに沿った API 呼び出しの確認
  3. 03オフライン環境での文書検索

MCP 対応

@ai-sdk/mcp には文書が含まれないことを示し、ai/docs のガイドとパッケージの型定義にある API を参照するよう案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/laguagu/claude-code-nextjs-skills --skill ai-sdk

インストール後、Claude Code で/ai-sdkを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
common-errors.md
devtools.md
examples.md
type-safe-agents.md

詳細

AI SDK のバージョンとドキュメントの参照先

関連するワークスペースのマニフェスト、ロックファイル、またはインストール済みパッケージで、ai とプロバイダー／React パッケージのバージョンを確認します。アップグレードが求められていない限り、インストール済みのメジャーバージョンを維持してください。

  • AI SDK 7 の実装または移行：ai-sdk-7 を使用します。
  • AI SDK 6 のメンテナンス：ai-sdk-6 を使用します。
  • バージョンが不明、混在、または古い場合：どちらかの API セットを適用する前に解決します。
  • 新しいアプリ：現行のメジャーバージョン（執筆時点では 7。npm view ai dist-tags で確認できます）から始めます。ai@7 は @ai-sdk/react@4 と、ai@6 は @ai-sdk/react@3 と組み合わせます。プロバイダーのメジャーバージョンはパッケージごとに異なるため、v7 では各プロバイダーの latest を、v6 では各プロバイダーの ai-v6 dist-tag をインストールします（npm view <pkg> dist-tags）。

アプリに合った API を見つける

まず、解決済みのパッケージ内にある docs/、型定義、そして（同梱されている場合は）src/ を検索します。これらはネットワークなしで利用できます。ai には 6.0.32 以降および 7.x のドキュメントが同梱されています。6.0.0～6.0.31 にはドキュメントがありません。ドキュメントツリーはウェブサイトに対応しています。ai-sdk.dev/docs/<section>/<page> は ai/docs/<nn>-<section>/<nn>-<page>.mdx に相当するため、これらのスキル内にある ai-sdk.dev/docs のリンクは、インストール済みのメジャーバージョンに含まれるコピーから参照できます。プロバイダーパッケージには docs/<nn>-<provider>.mdx が同梱されています。@ai-sdk/react、@ai-sdk/workflow、@ai-sdk/harness、@ai-sdk/otel、@ai-sdk/mcp にはドキュメントが同梱されていません。これらのガイドは ai/docs に、API は dist/*.d.ts にあります。モノレポのホイスティングや Yarn PnP によりパスが変わることがあります。ドキュメントを入手することだけを目的に、依存関係をインストールしたりアップグレードしたりしないでください。

ローカルのドキュメントを利用できない場合は、対応するリポジトリータグ（vercel/ai のタグ ai@<version>、content/docs/）またはドキュメントのバージョンを参照します。ドキュメント検索と Markdown ページ版を使うと、関連機能を見つけやすくなります。リポジトリーの main ブランチやウェブサイトのデフォルト版は、アプリより新しいメジャーバージョンを対象としている場合があります。ローカルのドキュメントもネットワーク接続も利用できない場合は、未検証のまま残る API の情報を明記します。 検索結果をメジャーバージョンに限定するには、&tag=v6（v5、v6、または v7）を追加します。

モデル ID は、アプリのプロバイダー設定または最新のプロバイダーカタログから選びます。Gateway カタログはモデルの確認に役立ちますが、掲載されている ID や機能の利用可否は、別のプロバイダーでも受け入れられることを意味しません。タスクに応じて機能、レイテンシ、コストを選択してください。

参照先

適切な場合はデフォルトを使用します。変更した連携部分の型チェックを行い、ストリーミング／ツールの経路を実際に動かして確認してください。シンボルがサポートされていても、コールバックのスコープ、結果のセマンティクス、またはプロバイダーの使い方が誤っている場合があります。

コメント

Markdown 対応