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
- Identifiziere das angegebene Client-Target: App-Name, Repository-Pfad, Paket/App-Verzeichnis, Prozess, PID, sichtbares Fenster und angeforderte Beweise.
- 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. - Bestätige den Startbefehl und die Laufzeitquelle vor der Überprüfung:
pnpm tauri dev, Debug-Bundle, Release-App, Electron/native Run-Befehl oderNicht gefunden/Nicht verifiziert, wenn unklar. - Liste echte Fenster auf und identifiziere die passende
CGWindowIDanhand von Besitzer, PID, Titel und Abmessungen. - Erfasse das echte Fenster, ohne auf Vordergrundfokus angewiesen zu sein:
screencapture -x -l<CGWindowID> /private/tmp/desktop-client-window.png - Überprüfe Screenshots mit
view_image, bevor du visuelle Beweise beanspruchst. - Bevorzuge hintergrundsichere Inspektion und Zugänglichkeitsaktionen wie
AXPressauf benannten Steuerelementen. - 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 stabiledata-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
- Siehe references/usage.md für Auslöseranleitung und Arbeitsablaufdetails.
- Siehe references/eval-cases.md für Auslöser- und Qualitätsbewertungen.