update-provider-models

update-provider-models skill 概覽

update-provider-models 的作用

update-provider-models skill 是一套聚焦於維護的工作流程，用來在 Vercel AI SDK 程式碼庫中新增新的 model ID，或移除已淘汰的 model ID。它特別適合程式碼編輯情境；如果只是下「更新 models」這種籠統指令，風險通常太高，因為 model ID 往往會同時出現在多個 package、型別清單、測試與範例中。

誰適合使用這個 skill

這個 update-provider-models skill 最適合以下使用者：

• 在 vercel/ai 中處理 provider 支援的貢獻者
• 根據 issue 處理 provider model 變更的維護者
• 被要求修改 model 清單、但又不能漏掉次要更新位置的 agent

真正要完成的工作是什麼

使用者通常需要的不只是單純替換一段字串。真正的任務是：找出某個 model 的所有精確引用位置、更新正確的 provider package 與共用介面、維持既有排序、避免誤改相似字串，並且在處理下一個 model 之前，先把當前這一個 model 的變更完整收乾淨。

為什麼它比泛用編輯提示更好

update-provider-models for Code Editing 的核心價值在於降低猜測空間。這個 skill 提供了明確的工作流程與限制，例如只能做精確比對搜尋、一次一個地處理多 model 請求，以及範例檔名的命名規則。這些細節很重要，因為這類錯誤通常不明顯：改錯 provider 介面、破壞字母排序，或不小心改到名稱相近的 model。

最適合與不適合的使用情境

適合在以下情況使用：

• 把新的 model ID 加到既有 provider 中
• 移除已淘汰的 model ID
• 處理包含多筆 model 新增／刪除的 provider issue

不要期待它從零開始設計全新的 provider 整合。這個 skill 的用途是更新既有 provider 的 model inventory，不是建立新的 adapter 架構。

如何使用 update-provider-models skill

如何安裝 update-provider-models

實用的 update-provider-models install 指令如下：

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

如果你的環境已經能識別已安裝的 skills，接著就可以直接點名這個 skill，並傳入具體的 provider 與 model 變更需求來執行。

這個 skill 需要哪些輸入

要讓這個 skill 發揮最佳效果，建議提供：

• provider 名稱
• 每個 model 是要新增還是移除
• 精確的 model ID
• 依據來源，例如 issue、changelog 或 provider 文件
• 這是單一變更還是批次處理

較弱的輸入：

• 「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.」

把模糊需求改寫成高品質 prompt

好的 update-provider-models usage prompt 通常會同時交代範圍、驗證方式與輸出期待：

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

這種格式能有效降低最常見的失敗情況：只改到其中一份清單，卻漏掉其他 package 或測試，導致變更不完整。

在 repository 裡應該先看什麼

先從這裡開始：

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

從這個 repository 的線索來看，這是一個單檔 skill，因此 SKILL.md 不只是概覽，而是實際操作規格。建議先讀「Critical Rules」區段，再看新增／移除的工作流程。

最需要記住的工作流程規則

上游 skill 特別強調幾條會直接影響輸出品質的規則：

• 使用精確比對，因為 model ID 可能只是其他名稱的子字串
• 在 arrays、unions 與 tables 中維持既有排序
• 範例檔名要用 kebab-case，且 . 要改成 -
• 多 model 請求要依序處理，一次完整跑完一個 model 的工作流程
• 必要時要同時更新主要 provider package，以及相關的 AI SDK 共用介面

這些正是一般泛用 prompt 最容易漏掉的細節。

如何處理新增與移除請求

對於新增，應把任務視為「找齊位置後再插入」：

1. 找出正確的 provider package，以及所有 model 清單所在介面
2. 找到能維持既有排序的插入位置
3. 如果 repository 慣例要求，也要同步更新相關範例或文件模式

對於移除，則應把任務視為「清理舊引用」：

1. 確認該 model 已淘汰，且只針對精確 ID 下手
2. 移除相關引用時，不要動到名稱相近的其他 model
3. 檢查範例、測試或 typed unions 是否仍提到它

如何安全處理批次變更

這個 skill 明確偏好循序處理。如果一個 issue 內包含很多 model 變更，請先把其中一個 model 的完整工作流程做完，再開始下一個。這樣可以避免 diff 混雜，也更容易在搜尋脈絡還很聚焦時，及早發現漏改檔案。

避免誤改的實用搜尋策略

使用 update-provider-models 時，不要只依賴單純的子字串搜尋。應先搜尋精確字串，再逐一檢查每個命中結果，確認它對應的是同一個 model 與 provider 情境。這對像 grok-3 和 grok-3-mini 這種名稱尤其重要，因為快速取代很容易把本來正確的相鄰條目一起改壞。

什麼樣的輸出才算好

一份好的 update-provider-models guide 結果，應該具備：

• 所有相關檔案都已更新，而不只是最顯眼的那一份清單
• 每個被修改的結構中都維持正確排序
• 沒有誤改名稱相近的 model ID
• 能按檔案清楚摘要新增／移除內容
• 若仍有模糊處，會附上信心檢查或備註

這個 skill 何時最省時間

以下情況最能體現這個 skill 的價值：

• 同一個 model ID 會出現在多個型別介面中
• 你正在時間壓力下處理 provider 更新 issue
• 你要把任務委派給需要明確防呆規則的 agent
• 該 provider 有許多名稱非常相近的 model 變體

update-provider-models skill 常見問題

update-provider-models 只適用於 vercel/ai 嗎？

它是依照 vercel/ai 的 repository 結構與慣例編寫的。雖然這套流程也可以調整後用在其他地方，但最高信心的使用情境，仍然是在該程式碼庫內更新 model ID。

它比直接叫 agent「search and replace」更好嗎？

是的，如果你在意正確性，答案就是更好。update-provider-models skill 的設計就是針對這個 repository 的特定風險：精確比對驗證、清單排序、跨介面更新，以及循序處理。泛用 prompt 也許改得更快，但更容易漏掉相依檔案，或破壞名稱相近的條目。

update-provider-models 對新手友善嗎？

算友善，前提是你已經能在 repository 中移動並檢查 diff。這套流程範圍明確、步驟具體。不過新手仍需要仔細確認 provider 範圍，並謹慎檢查搜尋結果，尤其是在 model 名稱彼此非常接近時。

可以拿它來處理全新的 provider 嗎？

通常不行。它不是從零建立 provider package 的首選工具。它的定位是更新既有 provider 整合中的 model ID。

如果我手上只有 provider issue，沒有精確的檔案清單呢？

這正是它很適合的情境。這個 skill 本來就假設你會透過搜尋找出受影響的位置。你只需要提供精確的 model ID，以及每一個是新增還是移除即可。

什麼情況下不該使用 update-provider-models？

如果需求真正重點是以下內容，就不該用它：

• 設計 provider 架構
• 修改與 ID 無關的 model 能力或行為邏輯
• 沒有程式碼變更的大範圍文件重寫
• model 名稱尚未確認的推測性更新

如何改進 update-provider-models skill 的使用效果

提供精確的 model ID 與明確依據來源

想提升 update-provider-models 的成果，最快的方法就是提供精確的 model 字串，以及來源對應的 provider 公告、文件頁面或 issue 連結。這樣 agent 才能分辨哪些是已確認的 ID，哪些只是猜測。

明確指出 provider package

如果你已經知道受影響的 provider，就直接寫出來。「Add model-x」遠不如「Add model-x to the Anthropic provider surfaces in vercel/ai」清楚。這能減少誤判，也能避免不必要的搜尋範圍擴大。

要求提供逐檔變更摘要

若想明顯提升輸出品質，其中一個最有效的方法，就是要求每個變更檔案都附上一小段修改理由。這能讓審查更容易，也能更快看出工作是否不完整，特別是在某個預期中的介面被漏掉時。

在 prompt 中強制要求精確比對驗證

可以直接加入這類指示：

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

這會直接針對此 repository 最大的正確性風險下手。

要求編輯後重新檢查排序

由於這個 skill 仰賴維持既有排序慣例，請明確要求 agent 在插入或刪除之後，再重新檢查一次清單順序。這能抓出那些在 diff review 時很容易被忽略、但實際上會造成問題的低可見度缺陷。

多個 model 更新要一個一個處理

如果是批次 issue，請要求 agent 先完整處理一個 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 常見問題包括：

• 誤改了子字串匹配結果
• 只在其中一份清單新增 model，卻沒更新所有必要介面
• 破壞字母排序或 repository 特有的排序規則
• model 名稱有 . 時，範例檔名命名錯誤
• 把多個 model 更新混在一次混亂的處理過程中

第一版結果出來後，應該怎麼迭代

如果第一版輸出看起來不完整，不要用含糊方式重下 prompt。改用明確的第二輪要求：

• 「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 變更都是精確匹配
• 排序仍符合當地既有慣例
• 若有新增範例或測試，檔名是否符合規則
• 移除後是否已沒有過時引用殘留

這套審查模式，是讓 update-provider-models for Code Editing 產出高信心結果最可靠的方法。