update-provider-models

update-provider-models skill の概要

update-provider-models でできること

update-provider-models skill は、Vercel AI SDK のコードベースで新しい model ID を追加したり、古くなったものを削除したりするための、用途を絞ったメンテナンス用ワークフローです。単に「モデルを更新して」と頼むだけでは危険なケース向けに作られており、実際には model ID が複数の package、型付きリスト、テスト、サンプルにまたがって存在することを前提にしています。

この skill が向いている人

この update-provider-models skill は、vercel/ai で provider 対応を進めるコントリビューター、issue ベースで provider の model 変更を処理するメンテナー、そしてモデル一覧の編集を任されつつ見落としを避けたいエージェントに最適です。

本当に片付けたい仕事

多くの場合、必要なのは単純な文字列置換ではありません。実際の作業は、ある model の正確な参照箇所をすべて見つけ、正しい provider package と共有 surface を更新し、並び順を崩さず、部分一致による誤編集を避け、1 つの model 変更をきれいに完了してから次へ進むことです。

汎用的な編集プロンプトより優れている理由

update-provider-models for Code Editing の価値は、推測に頼る余地を減らせる点にあります。この skill には、完全一致検索、複数モデル依頼の逐次処理、サンプル命名ルールといった明示的な制約を含むワークフローがあります。ここでのミスはたいてい地味で見つけづらく、provider surface の取り違え、アルファベット順の破壊、似た名前の model への誤編集といった形で現れます。

向いているケース / 向いていないケース

次のような場合に使ってください。

• 既存 provider に新しい model ID を追加する
• 廃止された model ID を削除する
• 複数の model 追加・削除を含む provider issue を処理する

一方で、新しい provider integration をゼロから設計する用途には向きません。この skill は既存 provider の model 一覧を更新するためのものであり、新しい adapter アーキテクチャを組み立てるものではありません。

update-provider-models skill の使い方

update-provider-models のインストール方法

実用的な update-provider-models install コマンドは次のとおりです。

npx skills add vercel/ai --skill update-provider-models

環境側ですでにインストール済み skill を呼び出せるなら、その後は skill 名を指定し、対象 provider と model の変更内容を具体的に渡して実行できます。

この skill に必要な入力

この skill は、次の情報があると最も安定して動きます。

• provider 名
• 各 model が追加か削除か
• 正確な model ID
• issue、changelog、provider docs などの source of truth
• 単発の変更か、まとめて処理する batch か

弱い入力例:

• “Update OpenAI models”

強い入力例:

• “Use update-provider-models to add gpt-4.1-mini to the existing provider model lists and examples in vercel/ai. Check all exact matches only, preserve existing ordering, and show me every file changed.”

あいまいな依頼を強いプロンプトに変える

よい update-provider-models usage プロンプトには、通常、スコープ・検証条件・出力の期待値が含まれます。

Use update-provider-models for Code Editing in vercel/ai.

Provider: [provider name]
Changes:
- add [exact-model-id]
- remove [exact-model-id]

Requirements:
- search for exact matches only
- update all relevant provider and shared locations
- preserve current sort/order conventions
- if examples are needed, use kebab-case filenames
- process one model completely before starting the next
- summarize why each file changed

この形式にすると、もっともよくある失敗、つまり 1 つのリストだけ更新して別の package や test を取りこぼすような中途半端な編集を防ぎやすくなります。

リポジトリで最初に読むべきもの

まず確認したいのは次です。

• skills/update-provider-models/SKILL.md

このリポジトリでは skill の実体が単一ファイルに集約されているため、SKILL.md は単なる概要ではなく、実運用の仕様書です。最初に “Critical Rules” を読み、その後で add/remove の各ワークフローを追ってください。

特に重要なワークフロールール

upstream の skill では、出力品質に直結するルールがいくつか強調されています。

• model ID は他の ID の部分文字列になりうるため、必ず完全一致で探す
• 配列、union、テーブルの既存の並び順を守る
• examples のファイル名は kebab-case を使い、ドットはハイフンに置き換える
• 複数 model の依頼は、1 件ずつフルワークフローで順番に処理する
• 必要に応じて、主要な provider package だけでなく関連する AI SDK の surface も更新する

こうした細部は、汎用プロンプトだと抜け落ちがちなポイントです。

追加依頼と削除依頼の扱い分け

追加の場合は、「発見してから挿入する」作業として扱います。

1. 正しい provider package と、model 一覧が現れるすべての surface を特定する
2. 並び順を保てる挿入位置を見つける
3. リポジトリ慣例が求めているなら、関連する examples や docs パターンも更新する

削除の場合は、「不要な参照を整理する」作業として扱います。

1. その model が本当に obsolete か確認し、対象は正確な ID のみに絞る
2. 似た名前の model を巻き込まずに参照を削除する
3. examples、tests、typed unions にまだ残っていないか確認する

batch を安全に処理する方法

この skill は、明示的に逐次処理を推奨しています。issue に大量の model 変更が含まれている場合でも、まず 1 つの model についてフルワークフローを完了してから次へ進めてください。diff が混ざりにくくなり、検索対象がまだ狭いうちに取りこぼしにも気づきやすくなります。

悪い編集を避けるための実践的な検索戦略

update-provider-models を使うときは、単純な部分文字列検索だけに頼らないでください。まず完全一致の文字列で検索し、ヒットごとに同じ model・同じ provider 文脈の参照かを確認します。たとえば grok-3 と grok-3-mini のような名前では、雑な置換をすると隣接する正しいエントリまで壊してしまいます。

良い出力の条件

update-provider-models guide のよい結果には、次の要素が含まれているはずです。

• 目立つ 1 つのリストだけでなく、関係するすべてのファイルが更新されている
• 編集した各構造の並び順が正しい
• 似た model ID への意図しない変更がない
• 追加・削除内容がファイル単位で明確に要約されている
• あいまいさが残った箇所には confidence check や注記がある

この skill が特に時間を節約する場面

この skill がもっとも効くのは、次のような状況です。

• 同じ model ID が複数の型付き surface に現れる
• provider update issue への対応を急いでいる
• 明確なガードレールが必要なエージェントに作業を委譲する
• provider に似た名前の model バリエーションが多い

update-provider-models skill の FAQ

update-provider-models は vercel/ai 専用ですか？

この skill は vercel/ai のリポジトリ構造と運用慣例を前提に書かれています。他の場所に応用することはできますが、もっとも高い確度で使えるのは、そのコードベース内で model ID を更新するケースです。

エージェントに “search and replace” させるより良いですか？

はい。正確さを重視するなら、その価値があります。update-provider-models skill は、リポジトリ固有のリスク、つまり完全一致の検証、リスト順序の維持、複数 surface への更新、逐次処理を前提に設計されています。汎用プロンプトのほうが速く編集できることはありますが、依存ファイルを見落としたり、似た名前のエントリを壊したりする可能性が高くなります。

update-provider-models は初心者でも使えますか？

はい。すでにリポジトリをたどって diff を確認できるなら使えます。ワークフロー自体は狭く具体的です。ただし初心者でも、provider の対象範囲を確認し、特に近い名前の model がある場合は検索結果を丁寧に見分ける必要があります。

新規 provider にも使えますか？

通常は向きません。これは provider package をゼロから作るための最初のツールではありません。既存 provider integration の model ID を更新する用途を想定しています。

provider issue しかなく、正確なファイル一覧がなくても使えますか？

問題ありません。むしろ一般的な使い方です。この skill は、影響箇所を検索で見つけていく前提で設計されています。各 model の正確な ID と、それが追加か削除かを渡してください。

update-provider-models を使わないほうがよいのはどんな時ですか？

次のような依頼なら、この skill は避けたほうがよいです。

• provider architecture の設計
• ID と無関係な model capability や behavior logic の変更
• コード変更を伴わない大規模な docs 書き換え
• model 名が確定していない段階での推測ベース更新

update-provider-models skill を改善するには

正確な model ID と source of truth を渡す

update-provider-models の結果をもっとも手早く改善する方法は、正確な model 文字列と、その出典になった provider announcement、docs page、issue link を渡すことです。これにより、確認済みの ID と推測をエージェントが区別しやすくなります。

provider package を明示する

影響を受ける provider がすでに分かっているなら、はっきり書いてください。“Add model-x” より、“Add model-x to the Anthropic provider surfaces in vercel/ai.” のほうが強い指示です。これで false positive や不要な検索を減らせます。

ファイルごとの変更要約を求める

出力品質を上げる定番の方法が、変更された各ファイルについて短い理由説明を求めることです。レビューしやすくなり、本来更新されるべき surface が 1 つ抜けているような不完全さもすぐ見つけやすくなります。

プロンプトで完全一致検証を必須にする

次のような指示を入れてください。

• “Verify every search hit is an exact model match, not a substring variant.”

これは、このリポジトリでもっとも大きい正確性リスクに直接効きます。

編集後の並び順チェックを必須にする

この skill は既存の sort ルールを守ることが前提なので、追加や削除のあとにリスト順を再確認するよう明示してください。diff レビューでは見逃されやすい、目立たない不具合を拾えます。

複数 model の更新は 1 件ずつ進める

batch issue では、1 つの model を最後まで終えてから次へ進むよう指示してください。検索文脈を正確に保てるため、巻き戻しやレビューもずっと簡単になります。

取りこぼし確認を要求する

強い追加入力の例として、次のような指示があります。

• “After edits, do one final search for the exact model ID to confirm no outdated references remain and no unintended references were changed.”

この最後のひと掃除で、出力への信頼性は大きく上がります。

よくある失敗パターン

update-provider-models usage で起きやすい問題は次のとおりです。

• 部分一致を誤って編集してしまう
• 1 つのリストだけに model を追加し、必要な surface 全体を更新しない
• アルファベット順やリポジトリ固有の並びを壊す
• ドットを含む model 名で example ファイル名を誤る
• 複数 model の更新を 1 回の分かりにくい処理に混ぜてしまう

初回ドラフトのあとにどう改善するか

最初の出力が不完全に見える場合、あいまいに再依頼しないでください。狙いを絞った 2 回目の指示にします。

• “Re-run update-provider-models for model-id and verify all exact matches across provider package, shared types, tests, and examples. List any files considered but intentionally unchanged.”

こうした反復のほうが、“double-check this.” よりはるかに強力です。

実践的なレビュー用チェックリスト

マージ前に、次を確認してください。

• provider が正しい
• 各 model ID の変更が完全一致で行われている
• 並び順がローカルの慣例に合っている
• 追加した examples や tests がファイル名ルールに従っている
• 削除後に obsolete な参照が残っていない

このレビューの型が、update-provider-models for Code Editing で高信頼な結果を得るためのもっとも確実な方法です。