idaibin/aicraft

Cliente de Escritorio (Ops Client)

Resumen

Opera y verifica ventanas reales de aplicaciones de escritorio. La guía actual está enfocada en Tauri, pero la habilidad aplica a aplicaciones cliente donde las vistas previas del navegador no son evidencia válida.

Flujo de trabajo

1. Identifica el objetivo del cliente especificado: nombre de la aplicación, ruta del repositorio, paquete/directorio de la aplicación, proceso, PID, ventana visible y evidencia solicitada.
2. Si trabajas desde un repositorio, confirma si contiene una aplicación de escritorio/cliente verificando manifiestos y la estructura del código fuente, como src-tauri/, tauri.conf.*, configuraciones de Electron, objetivos de aplicaciones nativas, scripts del paquete, tareas de justfile o instrucciones de ejecución en README.
3. Confirma el comando de inicio y la fuente del tiempo de ejecución antes de la verificación: pnpm tauri dev, paquete de depuración, aplicación de lanzamiento, comando de ejecución de Electron/nativo, o No encontrado/No verificado cuando no esté claro.
4. Enumera las ventanas reales e identifica el CGWindowID coincidente por propietario, PID, título y límites.
5. Captura la ventana real sin depender del foco del primer plano: screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png
6. Inspecciona las capturas de pantalla con view_image antes de reclamar evidencia visual.
7. Prefiere la inspección segura en segundo plano y las acciones de Accesibilidad, como AXPress en controles nombrados.
8. Reconstruye/reinicia la instancia del cliente deseada después de cambios relevantes en la interfaz de usuario, el paquete o la Accesibilidad antes de volver a verificar.

Modos

• Revisión de lanzamiento: identificar la aplicación cliente propiedad del repositorio y su comando de inicio antes de ejecutarla o verificarla.
• Evidencia de ventana: probar el proceso, el tiempo de ejecución, la identidad de la ventana y la fuente de la captura de pantalla.
• Interacción: usar rutas de Accesibilidad/árbol de control antes de hacer clics por coordenadas.
• Interfaz de usuario operable por IA: mejorar las superficies DOM y de Accesibilidad para que los agentes puedan identificar los controles de manera confiable.

No usar para

• Páginas web simples, vistas previas web, flujos de trabajo de formularios, descargas o comprobaciones de consola/red del navegador; usa ops-browser.
• Descubrimiento de repositorios ordinarios a menos que el usuario solicite revisión de lanzamiento de cliente, verificación de ventana real o invalidación de vista previa del navegador.
• Evidencia de vista previa del navegador cuando la tarea requiere prueba de un tiempo de ejecución de Tauri, Electron o escritorio nativo.
• Revisión de diferencias local, planificación o revisión solo de seguridad; usa la habilidad code-* correspondiente.

Reglas estrictas

• No trates las vistas previas del navegador, las páginas del servidor de desarrollo o las capturas de pantalla de región como evidencia de cliente de escritorio a menos que el usuario solicite explícitamente una comprobación solo de navegador.
• No inicies ni reinicies un cliente antes de confirmar la fuente del comando de inicio y si podría interferir con una instancia de aplicación existente, una ventana activa o el flujo de trabajo del usuario.
• No robes el mouse del usuario, muevas el puntero, actives ventanas no relacionadas ni hagas clic por coordenadas a menos que no exista una ruta de control estable y el riesgo sea aceptable.
• Prefiere controles semánticos, nombres accesibles, aria-label, title, sr-only, etiquetas de formulario asociadas y selectores data-testid estables para controles críticos.
• Di No verificado cuando el proceso, el tiempo de ejecución, la fuente de la ventana o la evidencia de interacción no estén verificados.

Contrato de salida

Informa sobre el objetivo del cliente especificado, la evidencia de propiedad del repositorio/cliente, el comando de inicio o No encontrado, el proceso/tiempo de ejecución objetivo, la evidencia de la ventana real, la fuente de la captura de pantalla, el método de interacción, las brechas de Accesibilidad o DOM, el estado de reinicio/reconstrucción y cualquier cosa No verificado.

Mantenimiento de la habilidad

Al mantener este paquete, actualiza references/eval-cases.md, references/usage.md y agents/openai.yaml cuando cambien el alcance del desencadenante, los modos, las reglas estrictas o el contrato de salida. En AICraft, ejecuta python3 scripts/validate-skills.py antes de publicar y npx skills add https://github.com/idaibin/aicraft --list después de publicar en GitHub.

Referencias

• Consulta references/usage.md para obtener orientación sobre desencadenantes y detalles del flujo de trabajo.
• Consulta references/eval-cases.md para evaluaciones de calidad y desencadenantes.