agente-dispositivo

O que agente-dispositivo faz?

Use esta skill como um roteador com padrões obrigatórios. Leia este arquivo primeiro. Para tarefas normais de dispositivo, sempre carregue references/bootstrap-install.md e references/exploration.md antes de agir. Use bootstrap para confirmar ou estabelecer uma configuração determinística. Use exploration para inspeção, interação e verificação da interface assim que a sessão do app estiver aberta.

Regras operacionais padrão

• Comece de forma conservadora. Prefira inspeção somente leitura antes de alterar a interface.
• Use snapshot simples quando a tarefa for verificar qual texto ou estrutura está visível na tela no momento.
• Use snapshot -i apenas quando precisar de referências interativas, como @e3 para uma ação solicitada ou consulta direcionada.
• Evite mutações especulativas. Você pode realizar a menor ação reversível na interface necessária para desbloquear a inspeção ou concluir a tarefa solicitada, como dispensar um pop-up, fechar um alerta ou limpar uma superfície não intencional.
• Não navegue pela web nem use fontes externas, a menos que o usuário solicite explicitamente.
• Tire um novo snapshot após alterações significativas na interface, em vez de reutilizar referências desatualizadas.
• Prefira @ref ou direcionamento por seletor em vez de coordenadas brutas.
• Certifique-se de que o alvo correto está fixado e uma sessão do app está aberta antes de interagir.
• Mantenha o ciclo curto: open -> inspecionar/agir -> verificar (se necessário) -> close.

Fluxo padrão

1. Carregue references/bootstrap-install.md e references/exploration.md antes de agir em uma tarefa normal de dispositivo.
2. Use bootstrap primeiro para confirmar ou estabelecer o alvo correto, instalação do app e sessão aberta do app.
3. Assim que a sessão do app estiver aberta e estável, use exploration para inspeção, interação e verificação.
4. Comece com snapshot simples se o objetivo for ler ou verificar o que está visível.
5. Escale para snapshot -i apenas se precisar de referências para exploração interativa ou uma ação solicitada.
6. Use get, is ou find antes de alterar a interface quando um comando somente leitura puder responder à pergunta.
7. Finalize capturando uma prova (se necessário) e depois close.

Modos de QA

• Caça a bugs com relatório: use ../dogfood/SKILL.md.
• QA de aprovação/reprovação a partir de critérios de aceitação: permaneça nesta skill, comece com references/bootstrap-install.md, depois use o loop de QA em references/exploration.md.

Referências obrigatórias

• Para toda tarefa normal de dispositivo, após ler este arquivo, carregue references/bootstrap-install.md primeiro, depois references/exploration.md, antes de agir.
• Use bootstrap para confirmar ou estabelecer configuração determinística, especialmente em ambientes sandbox ou em nuvem.
• Use exploration assim que a sessão do app estiver aberta e estável.
• Carregue referências adicionais apenas quando seu escopo for necessário.

Regras de decisão

• Use snapshot simples quando precisar verificar se um texto está visível.
• Use snapshot -i principalmente para exploração interativa e escolha de referências.
• Use get, is ou find quando puderem responder à pergunta sem alterar o estado da interface.
• Use fill para substituir texto.
• Use type para adicionar texto.
• Quando uma tarefa pedir para "voltar", use back simples para navegação previsível do app e reserve back --system para gestos de voltar da plataforma ou semântica de botão.
• Use type --delay-ms ou fill --delay-ms para campos de busca com debounce que perdem caracteres quando digitados muito rapidamente.
• Se não houver simulador, instalação do app ou sessão aberta ainda, mude para bootstrap-install.md em vez de improvisar etapas de configuração.
• Use a menor ação de desbloqueio primeiro quando uma interface transitória bloquear a inspeção, mas não navegue, pesquise ou insira novo texto apenas para fazer a interface revelar dados, a menos que o usuário tenha solicitado essa interação.
• Não use consultas externas para compensar dados ausentes na tela, a menos que o usuário as tenha solicitado.
• Se a informação necessária não estiver exposta na tela, diga isso claramente em vez de compensar com navegação extra, inserção de texto ou pesquisa na web.
• Prefira @ref ou direcionamento por seletor em vez de coordenadas brutas.

Referências adicionais

• Necessita de logs, rede, alertas, permissões ou investigação de falhas: references/debugging.md
• Necessita de screenshots, diff, gravação, manutenção de replay ou dados de perf: references/verification.md
• Necessita de superfícies de desktop, comportamento da barra de menus ou regras específicas de interação no macOS: references/macos-desktop.md
• Necessita de transporte remoto HTTP, inicializações --remote-config ou locações de tenant em um host macOS remoto: references/remote-tenancy.md