agent-device

Was macht agent-device?

Verwenden Sie diese Fähigkeit als Router mit obligatorischen Standardeinstellungen. Lesen Sie diese Datei zuerst. Für normale Geräteaufgaben laden Sie immer references/bootstrap-install.md und references/exploration.md, bevor Sie handeln. Verwenden Sie Bootstrap, um ein deterministisches Setup zu bestätigen oder herzustellen. Verwenden Sie Exploration für UI-Inspektion, Interaktion und Verifizierung, sobald die App-Sitzung geöffnet ist.

Standard-Betriebsregeln

• Fangen Sie konservativ an. Bevorzugen Sie schreibgeschützte Inspektion, bevor Sie die UI mutieren.
• Verwenden Sie snapshot ohne Optionen, wenn die Aufgabe darin besteht, zu überprüfen, welcher Text oder welche Struktur derzeit auf dem Bildschirm sichtbar ist.
• Verwenden Sie snapshot -i nur, wenn Sie interaktive Referenzen wie @e3 für eine angeforderte Aktion oder gezielte Abfrage benötigen.
• Vermeiden Sie spekulative Mutationen. Sie dürfen die kleinste reversible UI-Aktion ausführen, die erforderlich ist, um die Inspektion zu ermöglichen oder die angeforderte Aufgabe abzuschließen, z. B. das Schließen eines Popups, das Schließen eines Alarms oder das Löschen einer unbeabsichtigten Oberfläche.
• Durchsuchen Sie nicht das Web oder verwenden Sie externe Quellen, es sei denn, der Benutzer bittet explizit darum.
• Erstellen Sie nach sinnvollen UI-Änderungen erneut einen Snapshot, anstatt veraltete Referenzen wiederzuverwenden.
• Bevorzugen Sie @ref oder Selektor-Targeting gegenüber Rohkoordinaten.
• Stellen Sie sicher, dass das richtige Ziel angeheftet und eine App-Sitzung geöffnet ist, bevor Sie interagieren.
• Halten Sie die Schleife kurz: open -> inspizieren/handeln -> ggf. verifizieren -> close.

Standardablauf

1. Laden Sie references/bootstrap-install.md und references/exploration.md, bevor Sie bei einer normalen Geräteaufgabe handeln.
2. Verwenden Sie zuerst Bootstrap, um das korrekte Ziel, die App-Installation und die geöffnete App-Sitzung zu bestätigen oder herzustellen.
3. Sobald die App-Sitzung geöffnet und stabil ist, verwenden Sie Exploration für Inspektion, Interaktion und Verifizierung.
4. Beginnen Sie mit einem einfachen snapshot, wenn das Ziel darin besteht, zu lesen oder zu überprüfen, was sichtbar ist.
5. Gehen Sie nur dann zu snapshot -i über, wenn Sie Referenzen für die interaktive Exploration oder eine angeforderte Aktion benötigen.
6. Verwenden Sie get, is oder find, bevor Sie die UI mutieren, wenn ein schreibgeschützter Befehl die Frage beantworten kann.
7. Beenden Sie den Vorgang, indem Sie bei Bedarf einen Beweis aufnehmen, dann close.

QA-Modi

• Offene Fehlersuche mit Berichterstattung: Verwenden Sie ../dogfood/SKILL.md.
• Bestanden/Nicht bestanden QA aus Akzeptanzkriterien: Bleiben Sie in dieser Fähigkeit, beginnen Sie mit references/bootstrap-install.md, verwenden Sie dann die QA-Schleife in references/exploration.md.

Erforderliche Referenzen

• Laden Sie für jede normale Geräteaufgabe nach dem Lesen dieser Datei zuerst references/bootstrap-install.md, dann references/exploration.md, bevor Sie handeln.
• Verwenden Sie Bootstrap, um ein deterministisches Setup zu bestätigen oder herzustellen, insbesondere in Sandbox- oder Cloud-Umgebungen.
• Verwenden Sie Exploration, sobald die App-Sitzung geöffnet und stabil ist.
• Laden Sie zusätzliche Referenzen nur dann, wenn deren Umfang benötigt wird.

Entscheidungsregeln

• Verwenden Sie snapshot ohne Optionen, wenn Sie überprüfen müssen, ob Text sichtbar ist.
• Verwenden Sie snapshot -i hauptsächlich für die interaktive Exploration und die Auswahl von Referenzen.
• Verwenden Sie get, is oder find, wenn sie die Frage beantworten können, ohne den UI-Zustand zu ändern.
• Verwenden Sie fill, um Text zu ersetzen.
• Verwenden Sie type, um Text anzuhängen.
• Wenn eine Aufgabe darin besteht, „zurückzugehen“, verwenden Sie einfaches back für vorhersehbare, von der App gesteuerte Navigation und reservieren Sie back --system für plattformbezogene Zurück-Gesten oder Schaltflächensemantik.
• Verwenden Sie type --delay-ms oder fill --delay-ms für entprellte Suchfelder, die Zeichen fallen lassen, wenn zu schnell getippt wird.
• Wenn es keinen Simulator, keine App-Installation oder keine geöffnete App-Sitzung gibt, wechseln Sie zu bootstrap-install.md, anstatt Setup-Schritte zu improvisieren.
• Führen Sie zuerst die kleinste Entblockungsaktion aus, wenn eine vorübergehende UI die Inspektion blockiert, aber navigieren Sie nicht, suchen Sie nicht und geben Sie keinen neuen Text ein, nur um die UI Daten preiszugeben, es sei denn, der Benutzer hat nach dieser Interaktion gefragt.
• Verwenden Sie keine externen Lookups, um fehlende Bildschirmdaten zu kompensieren, es sei denn, der Benutzer hat danach gefragt.
• Wenn die benötigten Informationen nicht auf dem Bildschirm angezeigt werden, sagen Sie das klar, anstatt mit zusätzlicher Navigation, Texteingabe oder Websuche zu kompensieren.
• Bevorzugen Sie @ref oder Selektor-Targeting gegenüber Rohkoordinaten.

Zusätzliche Referenzen

• Bei Bedarf an Logs, Netzwerk, Alarme, Berechtigungen oder Fehlertriage: references/debugging.md
• Bei Bedarf an Screenshots, Diff, Aufzeichnung, Replay-Wartung oder Leistungsdaten: references/verification.md
• Bei Bedarf an Desktop-Oberflächen, Menüleistenverhalten oder macOS-spezifischen Interaktionsregeln: references/macos-desktop.md
• Bei Bedarf an Remote-HTTP-Transport, --remote-config-Starts oder Tenant-Leases auf einem Remote-macOS-Host: references/remote-tenancy.md