update-provider-models

Visão geral da skill update-provider-models

O que a update-provider-models faz

A skill update-provider-models é um fluxo de manutenção focado em adicionar novos IDs de modelo ou remover os obsoletos na codebase do Vercel AI SDK. Ela foi feita para tarefas de edição de código em que um pedido genérico como “atualize os modelos” é arriscado demais, porque os IDs de modelo costumam aparecer em vários pacotes, listas tipadas, testes e exemplos.

Quem deve usar esta skill

A update-provider-models skill é mais indicada para contribuidores que trabalham com suporte a providers em vercel/ai, mantenedores lidando com mudanças de modelos de providers a partir de issues e agentes encarregados de editar listas de modelos sem deixar passar pontos secundários de atualização.

O trabalho real que precisa ser feito

Na prática, os usuários quase sempre precisam de mais do que uma simples substituição de string. A tarefa real é identificar todas as referências exatas de um modelo, atualizar o pacote de provider correto e as superfícies compartilhadas, preservar a ordem de classificação, evitar erros por substring e concluir uma alteração de modelo por completo antes de passar para a próxima.

Por que ela é melhor do que um prompt genérico de edição

O principal valor de update-provider-models for Code Editing é reduzir a adivinhação. A skill oferece um fluxo com restrições explícitas, como busca por correspondência exata, tratamento sequencial de solicitações com vários modelos e regras de nomenclatura para exemplos. Isso importa porque os erros aqui costumam ser sutis: superfície de provider errada, ordem alfabética quebrada ou edições acidentais em modelos com nomes parecidos.

Casos de uso ideais e inadequados

Use a update-provider-models skill quando:

• for adicionar um novo ID de modelo a um provider existente
• for remover um ID de modelo obsoleto
• estiver processando uma issue de provider com várias adições/remoções de modelos

Não espere que ela projete uma nova integração de provider do zero. Esta skill é voltada a atualizar inventários de modelos de providers já existentes, não a construir uma nova arquitetura de adapter.

Como usar a skill update-provider-models

Como instalar a update-provider-models

Um comando prático de update-provider-models install é:

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

Se o seu ambiente já expõe as skills instaladas, você pode então chamá-la pelo nome da skill e passar o provider específico e a solicitação concreta de mudança de modelos.

Quais entradas a skill precisa

A update-provider-models skill funciona melhor quando você informa:

• o nome do provider
• se cada modelo será adicionado ou removido
• os IDs exatos dos modelos
• a fonte de verdade, como uma issue, changelog ou documentação do provider
• se é uma mudança única ou um lote

Entrada fraca:

• “Update OpenAI models”

Entrada forte:

• “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.”

Como transformar um pedido vago em um prompt forte

Um bom prompt de update-provider-models usage normalmente inclui escopo, validação e expectativa de saída:

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

Esse formato reduz o modo de falha mais comum: edições parciais que atualizam uma lista, mas deixam outro pacote ou teste de fora.

O que ler primeiro no repositório

Comece por:

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

Como as evidências deste repositório apontam para uma skill de arquivo único, SKILL.md não é apenas uma visão geral; ele funciona como a especificação operacional. Leia primeiro a seção “Critical Rules” e depois os fluxos de adição/remoção.

As regras de fluxo mais importantes para manter em mente

A update-provider-models skill upstream enfatiza algumas regras que mudam materialmente a qualidade da saída:

• use correspondência exata, porque IDs de modelo podem ser substrings de outros
• respeite a ordenação existente em arrays, unions e tabelas
• use nomes de arquivo em kebab-case para exemplos, trocando pontos por hífens
• trate solicitações com vários modelos de forma sequencial, um fluxo completo por vez
• atualize tanto o pacote principal do provider quanto as superfícies relacionadas do AI SDK quando necessário

São exatamente esses detalhes que um prompt genérico costuma deixar escapar.

Como tratar pedidos de adição versus remoção

Para adições, trate a tarefa como descoberta mais inserção:

1. identifique o pacote exato do provider e todas as superfícies de lista de modelos
2. encontre os pontos de inserção que preservem a ordenação
3. atualize exemplos relacionados ou padrões de documentação, se a convenção do repositório exigir isso

Para remoções, trate a tarefa como limpeza:

1. confirme que o modelo está obsoleto e mire apenas no ID exato
2. remova as referências sem tocar em modelos com nomes semelhantes
3. verifique se exemplos, testes ou typed unions ainda o mencionam

Como processar um lote com segurança

A update-provider-models skill prefere explicitamente o processamento sequencial. Se uma issue contiver muitas mudanças de modelo, conclua o fluxo completo de um modelo antes de começar o próximo. Isso evita diffs misturados e facilita identificar um arquivo esquecido enquanto o contexto de busca ainda está restrito.

Estratégia prática de busca para evitar edições ruins

Ao usar update-provider-models, não confie apenas em busca ingênua por substring. Procure as strings exatas e, em seguida, inspecione cada ocorrência para confirmar que ela se refere ao mesmo modelo e ao contexto correto de provider. Isso faz diferença em nomes como grok-3 versus grok-3-mini, em que uma substituição rápida pode corromper entradas vizinhas válidas.

Como é uma boa saída

Um bom resultado de um update-provider-models guide deve incluir:

• todos os arquivos relevantes atualizados, não apenas uma lista óbvia
• ordenação correta dentro de cada estrutura editada
• nenhuma alteração acidental em IDs de modelos parecidos
• um resumo claro das adições/remoções por arquivo
• verificações de confiança ou observações onde ainda houver ambiguidade

Quando esta skill mais economiza tempo

A update-provider-models skill é mais valiosa quando:

• o mesmo ID de modelo aparece em várias superfícies tipadas
• você está editando sob pressão de tempo por causa de uma issue de atualização de provider
• a tarefa está sendo delegada a um agente que precisa de guardrails explícitos
• o provider tem muitas variantes de modelo com nomes parecidos

FAQ da skill update-provider-models

A update-provider-models serve apenas para vercel/ai?

Ela foi escrita para a estrutura e as convenções do repositório vercel/ai. Dá para adaptar o fluxo em outros contextos, mas o caso de uso com maior confiança é a atualização de IDs de modelo dentro dessa codebase.

Isso é melhor do que pedir para um agente fazer “search and replace”?

Sim, se correção importa. A update-provider-models skill foi pensada em torno de riscos específicos do repositório: verificação por correspondência exata, ordenação de listas, atualizações em múltiplas superfícies e processamento sequencial. Um prompt genérico pode editar mais rápido, mas tem mais chance de deixar arquivos dependentes de fora ou danificar entradas com nomes semelhantes.

A update-provider-models é amigável para iniciantes?

Sim, desde que você já consiga navegar em um repositório e revisar diffs. O fluxo é estreito e concreto. Ainda assim, iniciantes precisam verificar com cuidado o escopo do provider e inspecionar os resultados de busca, especialmente quando há nomes de modelo quase duplicados.

Posso usar para um provider totalmente novo?

Em geral, não. Esta não é a ferramenta certa para criar um pacote de provider do zero. Ela foi feita para atualizar IDs de modelo em uma integração de provider já existente.

E se eu só tiver uma issue do provider e nenhuma lista exata de arquivos?

Esse é um caso normal de uso. A update-provider-models skill parte do princípio de que você vai descobrir os locais afetados por meio de busca. Basta fornecer os IDs exatos dos modelos e informar se cada um será adicionado ou removido.

Quando eu não devo usar a update-provider-models?

Evite usar a update-provider-models skill quando o pedido for, na verdade, sobre:

• projetar arquitetura de provider
• mudar capacidades de modelo ou lógica de comportamento sem relação com IDs
• reescritas amplas de documentação sem mudanças de código
• atualizações especulativas em que os nomes dos modelos ainda não estão confirmados

Como melhorar a skill update-provider-models

Forneça IDs de modelo exatos e uma fonte de verdade

A forma mais rápida de melhorar os resultados da update-provider-models é informar as strings exatas dos modelos e o anúncio do provider, a página de documentação ou o link da issue de onde elas vieram. Isso permite que o agente diferencie IDs confirmados de suposições.

Informe explicitamente o pacote do provider

Se você já souber qual provider foi afetado, diga isso. “Add model-x” é mais fraco do que “Add model-x to the Anthropic provider surfaces in vercel/ai.” Isso reduz falsos positivos e buscas desnecessárias.

Peça um resumo de mudanças por arquivo

Uma das melhores maneiras de elevar a qualidade da saída é solicitar uma justificativa curta para cada arquivo alterado. Isso facilita a revisão e expõe rapidamente trabalho incompleto, especialmente quando uma superfície esperada ficou de fora.

Force validação por correspondência exata no prompt

Inclua uma instrução como:

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

Isso ataca diretamente o maior risco de correção nesse repositório.

Exija checagem de ordenação após as edições

Como a update-provider-models skill depende de preservar as convenções de ordenação existentes, peça explicitamente ao agente para revisar a ordem das listas depois de inserir ou remover itens. Isso ajuda a capturar defeitos pouco visíveis que costumam passar na revisão de diff.

Trate atualizações com vários modelos uma a uma

Em issues em lote, diga ao agente para concluir um modelo por completo antes de passar ao próximo. Isso mantém o contexto de busca preciso e torna rollback ou revisão muito mais simples.

Peça verificação de superfícies possivelmente esquecidas

Uma instrução complementar forte é:

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

Essa varredura final aumenta materialmente a confiança na saída.

Modos de falha comuns para observar

Problemas típicos de update-provider-models usage incluem:

• editar correspondências por substring por engano
• adicionar um modelo em uma lista, mas não em todas as superfícies necessárias
• quebrar a ordem alfabética ou a ordem específica do repositório
• nomear arquivos de exemplo incorretamente quando há pontos no nome
• misturar várias atualizações de modelo em uma única passada confusa

Como iterar após o primeiro rascunho

Se a primeira saída parecer incompleta, não refaça o prompt de forma vaga. Peça uma segunda passada direcionada:

• “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.”

Esse tipo de iteração é muito mais forte do que simplesmente dizer “double-check this”.

Um checklist prático de revisão

Antes de fazer merge, confirme:

• o provider está correto
• cada alteração de ID de modelo é exata
• a ordenação ainda segue as convenções locais
• exemplos ou testes seguem as regras de nomenclatura de arquivos, se tiverem sido adicionados
• nenhuma referência obsoleta permaneceu após as remoções

Esse padrão de revisão é a forma mais confiável de obter resultados de alta confiança com update-provider-models for Code Editing.