foundation-models-on-device

Visão geral da skill foundation-models-on-device

O que faz foundation-models-on-device

A skill foundation-models-on-device ajuda você a projetar e implementar recursos com Apple FoundationModels que rodam localmente no iOS 26+. Ela é ideal para apps que precisam de geração de texto, saída estruturada guiada com @Generable, chamada de ferramentas ou streaming de snapshots, sem enviar dados do usuário para um modelo na nuvem.

Quem deve usar

Use a skill foundation-models-on-device se você está criando um recurso de IA para iPhone ou iPad e precisa de privacidade, resiliência offline ou integração com Apple Intelligence. Ela é uma ótima opção para times de produto, engenheiros iOS e desenvolvedores com mentalidade de backend que querem entender o contrato do lado do app antes de acoplar a lógica de servidor.

O que importa antes de adotar

O principal ponto de decisão é suporte de dispositivo e sistema operacional: esse fluxo depende da disponibilidade do Apple Intelligence e do framework FoundationModels no iOS 26+. Se você precisa de cobertura ampla de dispositivos, fallback em nuvem ou ferramentas de prompt agnósticas de modelo, esta skill cobre só uma parte da solução.

Como usar a skill foundation-models-on-device

Instale e abra os arquivos certos

Instale a skill foundation-models-on-device com:
npx skills add affaan-m/everything-claude-code --skill foundation-models-on-device

Comece por SKILL.md e leia o arquivo inteiro antes de editar o código. Este repositório não tem scripts extras nem pastas de referência, então o conteúdo da skill é a fonte da verdade.

Transforme um objetivo vago em um prompt útil

O uso de foundation-models-on-device funciona melhor quando você descreve o recurso, o formato de entrada e o formato de saída esperado. Por exemplo, peça “uma tela SwiftUI que verifique a disponibilidade, inicie uma sessão só quando houver suporte e retorne saída estruturada em JSON para uma nota de tarefa”. Isso é melhor do que “adicione IA ao meu app”, porque a skill foi pensada em torno de checagem de disponibilidade, configuração de sessão, geração estruturada e streaming.

Mapeie a skill para a sua implementação

Para foundation-models-on-device no contexto de Backend Development, a mentalidade útil é contract-first: defina o que o app precisa gerar, validar ou transmitir antes de desenhar as APIs ao redor. Se o seu app já tem endpoints de backend, decida se o modelo local será usado para rascunho, resumo, classificação ou apoio à interface, e mantenha o papel do servidor estreito.

Leia primeiro estes padrões

Comece pelos padrões centrais da skill: checagem de disponibilidade, fluxo básico de sessão, geração guiada com @Generable e chamada de ferramentas. Essas são as partes de maior sinal do guia foundation-models-on-device, porque determinam se o seu código vai rodar em dispositivos elegíveis e se a saída vai continuar estruturada o suficiente para uso em produção.

FAQ da skill foundation-models-on-device

foundation-models-on-device é só para apps iOS?

Sim. Esta skill é centrada no framework on-device FoundationModels da Apple, então ela é principalmente relevante para desenvolvimento de apps no iOS 26+. Se você precisa de suporte web, Android ou LLM do lado do servidor, use outra skill.

Preciso ter o Apple Intelligence ativado?

Na maioria dos casos, sim. Uma das primeiras verificações na skill foundation-models-on-device é a disponibilidade do modelo, porque o recurso pode ficar indisponível se o dispositivo não for elegível, se o Apple Intelligence estiver desativado ou se o modelo ainda estiver sendo baixado.

Em que isso é diferente de um prompt normal?

Um prompt normal diz ao modelo o que fazer. A skill foundation-models-on-device entrega o caminho de implementação: quando ativar, como bloquear por disponibilidade, como moldar a saída com @Generable e como fazer streaming ou chamadas de ferramentas com segurança no próprio dispositivo.

É amigável para iniciantes?

É amigável para iniciantes se você já conhece Swift ou SwiftUI básicos. Ela é menos indicada se você ainda está aprendendo arquitetura de apps, porque o difícil não é promptar — é integrar corretamente disponibilidade do modelo, respostas estruturadas e estado de interface.

Como melhorar a skill foundation-models-on-device

Descreva com precisão a tarefa a ser feita

Entradas melhores geram saídas melhores. Em vez de pedir um genérico “chat de IA”, especifique a ação do usuário e o resultado, como “resumir uma nota em três bullets”, “extrair campos de um recibo” ou “redigir uma resposta com acesso a dados de calendário via tool”.

Declare suas restrições logo de início

Mencione o dispositivo-alvo, a versão mínima do sistema, se você precisa de comportamento offline e se a saída estruturada é obrigatória. Essas restrições importam em foundation-models-on-device porque mudam se o recurso deve estar disponível e se a implementação deve usar geração simples, @Generable ou chamada de ferramentas.

Peça também o caminho de falha, não só o caminho feliz

A skill funciona melhor quando você solicita tratamento de disponibilidade, UI de fallback e validação de entrada no mesmo pedido. Um bom prompt de iteração pede “fluxo para dispositivo suportado mais estados de não elegível, não ativado e não pronto”, para que o resultado fique pronto para produção e não apenas para demonstração.

Revise o código gerado pensando nos limites do modelo

O erro mais comum é assumir que o modelo on-device pode substituir a lógica do produto. Use a skill para melhorar rascunho, extração e apoio à interface, e mantenha autorização, persistência e regras críticas de negócio fora do caminho do modelo.