idaibin/aicraft

Cliente Ops

Visão Geral

Opere e verifique janelas reais de clientes desktop. A orientação atual é focada em Tauri, mas a habilidade se aplica a aplicativos cliente onde previews de navegador não são evidências válidas.

Fluxo de Trabalho

1. Identifique o alvo do cliente especificado: nome do aplicativo, caminho do repositório, diretório do pacote/aplicativo, processo, PID, janela visível e evidência solicitada.
2. Se estiver trabalhando a partir de um repositório, confirme se ele contém um aplicativo desktop/cliente verificando manifestos e a estrutura de arquivos como src-tauri/, tauri.conf.*, configurações Electron, alvos nativos de aplicativos, scripts de pacote, tarefas justfile ou instruções de execução no README.
3. Confirme o comando de inicialização e a fonte de tempo de execução antes da verificação: pnpm tauri dev, pacote de depuração, aplicativo de lançamento, comando de execução Electron/nativo, ou Não encontrado/Não verificado quando não estiver claro.
4. Enumere janelas reais e identifique o CGWindowID correspondente pelo proprietário, PID, título e limites.
5. Capture a janela real sem depender de foco em primeiro plano: screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png
6. Inspecione capturas de tela com view_image antes de afirmar evidência visual.
7. Prefira inspeção segura em segundo plano e ações de Acessibilidade como AXPress em controles nomeados.
8. Reconstrua/reinicie a instância pretendida do cliente após alterações relevantes na interface, pacote ou Acessibilidade antes de re-verificar.

Modos

• Revisão de Inicialização: identifique o aplicativo cliente de propriedade do repositório e seu comando de inicialização antes de executá-lo ou verificá-lo.
• Evidência de Janela: prove processo, tempo de execução, identidade da janela e fonte da captura de tela.
• Interação: use caminhos de árvore de controle/acessibilidade antes de cliques por coordenadas.
• Interface Operável por IA: melhore superfícies DOM e de Acessibilidade para que agentes possam identificar controles de forma confiável.

Não Usar Para

• Páginas simples de navegador, previews web, fluxos de formulário, downloads ou verificações de console/rede do navegador; use ops-browser.
• Descoberta comum de repositório, a menos que o usuário peça revisão de inicialização de cliente, verificação de janela real ou invalidação de preview de navegador.
• Evidência de preview de navegador quando a tarefa exigir prova de um tempo de execução Tauri, Electron ou desktop nativo.
• Revisão de diff local, planejamento ou revisão apenas de segurança; use a habilidade code-* relevante.

Regras Rígidas

• Não trate previews de navegador, páginas de servidor de desenvolvimento ou capturas de tela de região como evidência de cliente desktop, a menos que o usuário peça explicitamente verificação apenas no navegador.
• Não inicie ou reinicie um cliente antes de confirmar a fonte do comando de inicialização e se isso pode perturbar uma instância existente do aplicativo, janela ativa ou fluxo de trabalho do usuário.
• Não roube o mouse do usuário, mova o ponteiro, ative janelas não relacionadas ou clique por coordenadas a menos que nenhum caminho de controle estável exista e o risco seja aceitável.
• Prefira controles semânticos, nomes acessíveis, aria-label, title, sr-only, rótulos de formulário associados e seletores data-testid estáveis para controles críticos.
• Diga Não verificado quando o processo, tempo de execução, fonte da janela ou evidência de interação não forem verificados.

Contrato de Saída

Relate o alvo do cliente especificado, evidência de propriedade do repositório/cliente, comando de inicialização ou Não encontrado, processo/tempo de execução alvo, evidência de janela real, fonte da captura de tela, método de interação, lacunas de acessibilidade ou DOM, status de reinicialização/reconstrução e qualquer coisa Não verificado.

Manutenção da Habilidade

Ao manter este pacote, atualize references/eval-cases.md, references/usage.md e agents/openai.yaml quando o escopo de acionamento, modos, regras rígidas ou contrato de saída mudar. No AICraft, execute python3 scripts/validate-skills.py antes de publicar e npx skills add https://github.com/idaibin/aicraft --list após publicar no GitHub.

Referências

• Veja references/usage.md para orientação de acionamento e detalhes do fluxo de trabalho.
• Veja references/eval-cases.md para acionamento e avaliações de qualidade.