Communitygithub.com

Ops Client

Betrieb und Überprüfung von Desktop-Client-Fenstern mit Schwerpunkt auf Tauri-, Electron- und nativen Desktop-Apps, insbesondere wenn Browser-Vorschauen nicht als Belege ausreichen.

Was ist Ops Client?

Der Skill **Ops Client** ermöglicht KI-Agenten, echte Desktop-Client-Fenster zu betreiben und zu verifizieren. Er ist besonders nützlich für Entwickler, die mit Tauri-, Electron- oder nativen Desktop-Apps arbeiten, bei denen Browser-Vorschauen keine gültigen Beweise liefern. Der Workflow umfasst das Identifizieren des Client-Targets (App-Name, Repository-Pfad, Prozess, Fenster), das Überprüfen von Startup-Befehlen und Laufzeitquellen sowie das Aufnehmen von Screenshots über die `CGWindowID` ohne Vordergrundfokus. Er stellt sicher, dass Zugänglichkeits- und DOM-Oberflächen optimiert werden, damit Agenten Steuerelemente zuverlässig identifizieren können. Der Skill vermeidet Browser-Vorschauen, unnötige Interaktionen mit dem Benutzer-Mauszeiger und nicht verifizierte Beweise. Er ist auf Plattformen wie Claude Code, Cursor und Codex anwendbar und folgt strikten Regeln wie der Verwendung von `AXPress` für Zugänglichkeitsaktionen und der Bevorzugung von stabilen Selektoren (`aria-label`, `data-testid`). Der Skill umfasst Modi wie Launch Review, Window Evidence, Interaction und AI-Operable UI. Die Wartung umfasst das Aktualisieren von Referenzdokumenten und die Validierung über ein Skript.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add idaibin/aicraft

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Ops Client?

Übersicht

Betreiben und Überprüfen von echten Desktop-Client-Fenstern. Die aktuelle Anleitung ist auf Tauri ausgerichtet, aber der Skill gilt für Client-Apps, in denen Browser-Vorschauen keine gültigen Beweise sind.

Arbeitsablauf

  1. Identifiziere das angegebene Client-Target: App-Name, Repository-Pfad, Paket/App-Verzeichnis, Prozess, PID, sichtbares Fenster und angeforderte Beweise.
  2. Wenn von einem Repository aus gearbeitet wird, bestätige, ob es eine Desktop-/Client-App enthält, indem du Manifests und die Quellstruktur wie src-tauri/, tauri.conf.*, Electron-Konfigurationen, native App-Ziele, Paket-Skripte, Justfile-Aufgaben oder README-Ausführungsanweisungen prüfst.
  3. Bestätige den Startbefehl und die Laufzeitquelle vor der Überprüfung: pnpm tauri dev, Debug-Bundle, Release-App, Electron/native Run-Befehl oder Nicht gefunden/Nicht verifiziert, wenn unklar.
  4. Liste echte Fenster auf und identifiziere die passende CGWindowID anhand von Besitzer, PID, Titel und Abmessungen.
  5. Erfasse das echte Fenster, ohne auf Vordergrundfokus angewiesen zu sein: screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png
  6. Überprüfe Screenshots mit view_image, bevor du visuelle Beweise beanspruchst.
  7. Bevorzuge hintergrundsichere Inspektion und Zugänglichkeitsaktionen wie AXPress auf benannten Steuerelementen.
  8. Baue/starte die beabsichtigte Client-Instanz nach relevanten UI-, Bundle- oder Zugänglichkeitsänderungen neu, bevor du erneut überprüfst.

Modi

  • Launch Review: Identifiziere die dem Repository zugehörige Client-App und ihren Startbefehl, bevor du sie ausführst oder überprüfst.
  • Window Evidence: Weise Prozess, Laufzeit, Fensteridentität und Screenshot-Quelle nach.
  • Interaction: Verwende Zugänglichkeits-/Steuerungspfade vor Koordinatenklicks.
  • AI-Operable UI: Verbessere DOM- und Zugänglichkeitsoberflächen, damit Agenten Steuerelemente zuverlässig identifizieren können.

Nicht Verwenden Für

  • Gewöhnliche Browserseiten, Webvorschauen, Formularabläufe, Downloads oder Browser-Konsolen-/Netzwerkchecks; verwende ops-browser.
  • Normale Repository-Erkundung, es sei denn, der Benutzer fragt nach Client-Launch-Review, echter Fensterüberprüfung oder Browser-Vorschau-Ungültigmachung.
  • Browser-Vorschau-Beweise, wenn die Aufgabe einen Nachweis von einem Tauri-, Electron- oder nativen Desktop-Laufzeitumfeld erfordert.
  • Lokale Diff-Überprüfung, Planung oder reine Sicherheitsüberprüfung; verwende das entsprechende code-* Skill.

Harte Regeln

  • Behandle Browser-Vorschauen, Dev-Server-Seiten oder regionale Screenshots nicht als Desktop-Client-Beweise, es sei denn, der Benutzer bittet explizit um reine Browser-Überprüfung.
  • Starte oder starte einen Client nicht neu, bevor du die Startbefehlquelle und ob dies eine bestehende App-Instanz, ein aktives Fenster oder einen Benutzerarbeitsablauf stören könnte, bestätigt hast.
  • Stehle nicht die Maus des Benutzers, bewege den Zeiger nicht, aktiviere keine irrelevanten Fenster und führe keine Koordinatenklicks aus, es sei denn, es existiert kein stabiler Steuerungspfad und das Risiko ist akzeptabel.
  • Bevorzuge semantische Steuerelemente, zugängliche Namen, aria-label, title, sr-only, zugehörige Formularbezeichnungen und stabile data-testid-Selektoren für wichtige Steuerelemente.
  • Sage Nicht verifiziert, wenn Prozess, Laufzeit, Fensterquelle oder Interaktionsbeweise ungeprüft sind.

Ausgabe-Kontrakt

Berichte das angegebene Client-Target, Nachweise für Repository/Client-Zugehörigkeit, Startbefehl oder Nicht gefunden, Zielprozess/Laufzeit, echte Fensterbeweise, Screenshot-Quelle, Interaktionsmethode, Zugänglichkeits- oder DOM-Lücken, Neustart-/Neubau-Status und alles, was Nicht verifiziert ist.

Skill-Wartung

Wenn du dieses Paket wartest, aktualisiere references/eval-cases.md, references/usage.md und agents/openai.yaml, wenn sich der Auslöserbereich, Modi, harte Regeln oder der Ausgabe-Kontrakt ändern. Führe in AICraft python3 scripts/validate-skills.py vor der Veröffentlichung und npx skills add https://github.com/idaibin/aicraft --list nach der Veröffentlichung auf GitHub aus.

Referenzen

Verwandte Skills