Melhores Práticas de Habilidades de Agente
Um resumo condensado das 25 melhores práticas mais importantes extraídas de cada página desta seção.
//
Busque em todas as páginas da documentação
Um resumo condensado das 25 melhores práticas mais importantes extraídas de cada página desta seção.
Habilidades são playbooks, não tutoriais: Arquivos SKILL.md dizem aos agentes como executar - Noções Básicas de Habilidades de Agente define a estrutura; Noções Básicas de EAS Build ensina conceitos.
Fixe a stack em cada habilidade: React 19.2.3, RN 0.86.0, Expo SDK 57 (expo ~57.0.4) - habilidades não fixadas alucinam APIs depreciadas.
Uma habilidade por domínio de decisão: Lançamento, roteamento, revisão nativa, testes, atualização, incidente - nunca uma mega-habilidade.
Declare entradas antes de agir: eas.json, app.config.ts, IDs de bundle, runtimeVersion, último updateId bom - agentes adivinham sem eles.
Saídas devem ser verificáveis: Comandos e checklists, não resumos em prosa - rejeite execuções de habilidade que omitam npx expo-doctor.
Guardrails são a seção de maior valor: Limites de OTA vs build, regras de credenciais, pausa de rollout - veja Habilidade de Lançamento EAS.
Invoque habilidades em pontos de decisão: Primeiro lançamento em produção, atualização de SDK, tempestade de crashes - não para ler documentação introdutória.
Documentos humanos permanecem a fonte da verdade: Habilidades linkam para Rotas Tipadas, Maestro E2E, Plugins de Configuração - não duplique.
Execute npx expo-doctor após mudanças de dependência: Gate obrigatório em Habilidade de Atualização de SDK e em cada habilidade que afeta o nativo.
Use npx expo install em habilidades: Nunca fixe manualmente as versões expo-* - o alinhamento do SDK 57 se desvia caso contrário.
Classifique JS-only vs. impactando nativo antes do lançamento: Módulo nativo, plugin ou permissão → eas build - OTA sozinho é inseguro.
runtimeVersion em cada invocação de habilidade OTA: Discrepância requer binário da loja - Política de Runtime Version.
Habilidades do Expo Router habilitam typedRoutes: Regenerar com npx expo start; verifique npx tsc --noEmit - Habilidade do Expo Router.
Valide parâmetros de deep-link em tempo de execução: Zod na entrada da tela - tipos Href gerados não provam entrada maliciosa.
Habilidades nativas preferem plugins de configuração: prebuild --clean do CNG apaga ios/ editado manualmente - Habilidade de Módulo Nativo.
Plugins idempotentes apenas: Um segundo prebuild --clean deve produzir um diff git vazio.
Bridges de App → Expo Modules; TurboModules para bibliotecas RN: A Nova Arquitetura do RN 0.86 é o padrão - teste no dispositivo.
Habilidades de teste respeitam a pirâmide: Muitos Jest, poucos Maestro - Habilidade de Teste Mobile.
appId do Maestro deve corresponder ao ID do bundle: Discrepâncias de nome de exibição causam falhas silenciosas no fluxo.
E2E em builds e2e-test do EAS: Expo Go não tem a forma de produção - combine com type: maestro do EAS Workflows.
Habilidades de atualização de SDK usam branches dedicados: prebuild --clean, doctor, pré-visualize a matriz de eas build antes da produção.
Habilidades de incidente contêm "antes de diagnosticar": Pause o rollout em fases/etapas; atribua o IC - Habilidade de Triagem de Incidentes.
Marque crashes com buildNumber + updateId + rota: Triagem sem repro - Melhores Práticas de Observabilidade.
Rollback OTA < 15 minutos em caso de regressão JS: Registre updateId conhecido como bom em cada ticket de lançamento - Runbook de Rollback.
Atualize habilidades após postmortems: Cada guardrail perdido se torna um novo item - versiona habilidades com semver no espírito de createRunOncePlugin.
.cursor/skills/ no repositório do app para convenções específicas do projeto eas.json; registro da organização para playbooks compartilhados de incidentes e atualizações. Sempre fixe a versão do SDK.
A habilidade pode criar diffs - o capitão de lançamento humano aprova antes das execuções não interativas do CI. Guardrails bloqueiam o envio para a trilha de produção sem um prompt explícito.
Habilidade de Atualização de SDK orquestra os mesmos gates para agentes - as notas de lançamento oficiais permanecem autoritárias para mudanças que quebram compatibilidade.
Não. Habilidades aceleram checklists; Resposta a Incidentes da Loja e runbooks de rollback detêm a autoridade de produção.
Após qualquer atualização de SDK, mudança na política de runtimeVersion, ou item de ação de postmortem. Execute npx expo-doctor na seção de verificação da habilidade ao atualizar.
Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (
expo~57.0.4).
Revisado por Chris St. John·Última atualização: 19 de jul. de 2026