Setze einen Logger dort ein, wo die Fehlersuche stockt
Wenn du bei einem Ablauf in einer Mac-App nur weißt, dass „irgendetwas passiert ist“, kommst du oft nicht weiter, indem du allein den Code prüfst. Bitte Codex, für einen bestimmten Ablauf einige aussagekräftige Einträge im zentralen Protokoll von macOS zu ergänzen. Lass Codex dann die App starten, den Ablauf auslösen und in der App „Konsole“ oder mit log stream prüfen, ob die erwarteten Ereignisse eingetreten sind.
Verwende dafür das Plugin „Build macOS Apps“. Der zugehörige Skill für macOS-Telemetrie beschränkt sich bewusst auf das Wesentliche. Verwende Apples Logger, wähle eine eindeutige Kombination aus Subsystem und Kategorie und protokolliere Beginn und Ende von Aktionen sowie Zustandswechsel. Lass sensible Nutzdaten aus. Erstelle und starte die App lokal und prüfe, ob das Ereignis im Protokoll erscheint. So siehst du, ob die Instrumentierung tatsächlich funktioniert.
Warum Telemetrie bei der Entwicklung mit Agenten hilft
Mit aussagekräftigen Logs kann Codex nach jedem Patch denselben Ablauf überprüfen. Der Agent kann die App starten, den Ablauf durchspielen, die gefilterten Logs auswerten und anhand der Ergebnisse entscheiden, was er als Nächstes am Code ändert. So musst du nicht jedes Fenster, jede Menüaktion oder jeden Zustandswechsel bei der Synchronisierung selbst prüfen.
Das ist besonders bei drei Arbeitsweisen hilfreich:
- Selbstständige Fehlersuche: Codex ergänzt Logs für einen auffälligen Ablauf, startet die App, klickt in die Seitenleiste oder löst einen Befehl aus. Anhand der protokollierten Ereignisfolge korrigiert Codex den Code, der den Zustand aktualisiert. Anschließend wiederholt Codex denselben Ablauf, bis die Logs mit dem Verhalten der Benutzeroberfläche übereinstimmen.
- Aufzeichnung einer App-Sitzung: Codex ergänzt je ein Ereignis für den App-Start, das Öffnen eines Fensters, die Auswahl in der Seitenleiste sowie für den Beginn, den erfolgreichen Abschluss und das Scheitern eines Imports. Dann führt Codex eine lokale Sitzung durch und fasst die Ereignisse chronologisch zusammen. So fällt auf, wenn Zustandswechsel fehlen oder in der falschen Reihenfolge erfolgen.
- Aufzeichnung während der manuellen Fehlersuche: Codex startet die App mit aktivierter Protokollierung und lässt einen gefilterten Logstream mitlaufen, während du einen kniffligen Ablauf von Hand durchspielst. Anschließend wertet Codex die Aufzeichnung aus und schlägt auf dieser Grundlage den nächsten Patch vor.
Beschränke die Instrumentierung auf wenige, gut filterbare Einträge
Bitte Codex, pro Funktionsbereich einen Logger einzurichten. Nicht jede Zustandsänderung braucht einen dauerhaften Logeintrag. Mit Kategorien wie Windowing, Commands, MenuBar, Sidebar, Sync oder Import kannst du die Logs bei der nächsten Fehlersuche gezielt filtern.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16import SwiftUI
struct SidebarItem { let id: String }
@MainActor private var selection: String?
import OSLog
private let logger = Logger(
subsystem: Bundle.main.bundleIdentifier ?? "SampleApp",
category: "Sidebar"
)
@MainActor
func selectItem(_ item: SidebarItem) {
logger.info("Selected sidebar item: \(item.id, privacy: .public)")
selection = item.id
}
Verwende info für knappe Meldungen zu Aktionen und Lebenszyklusereignissen, die auch später noch nützlich sind. Nutze debug für ausführlichere Angaben zum lokalen Zustand, die du vor Abschluss der Aufgabe entfernen oder auf eine niedrigere Protokollstufe setzen kannst. Ergänze Signposts nur, wenn du die Dauer eines Vorgangs misst.
Lass Codex das Ereignis anhand der Logs nachweisen
Mit den Logger-Aufrufen allein ist die Prüfung noch nicht abgeschlossen. Bitte Codex, die App zu starten und den instrumentierten Ablauf auszulösen. Lass dir den genauen Filter aus der App „Konsole“ oder das verwendete Prädikat für log stream zusammen mit ein oder zwei typischen Logzeilen zeigen.
log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'
Fehlt ein erwartetes Ereignis, bitte Codex, den Logaufruf näher an den vermuteten Ausführungspfad zu verschieben und denselben Ablauf erneut durchzuspielen. Lass Codex das wiederholen, bis die Logs zeigen, was passiert ist. Wenn du einen Absturz oder einen Backtrace untersuchen musst, wechsle zum Debugging-Workflow des Plugins für das Erstellen und Ausführen der App. Beschränke die Telemetrie dabei auf Beginn und Ende der Aktionen.
Speichere die Sitzungsaufzeichnung für einen späteren Codex-Durchlauf
Bei langwierigen oder sporadischen Fehlern kannst du Codex bitten, einen gefilterten Logstream in einer kleinen lokalen Trace-Datei zu speichern, den zeitlichen Ablauf zusammenzufassen und die Datei im Workspace zu belassen. So kann Codex später dieselben Ereignisse untersuchen, ohne die gesamte Sitzung aus dem Gedächtnis nachstellen zu müssen. Das erleichtert die Fehlersuche über mehrere Durchläufe hinweg. In einem Durchlauf kann der Agent die Ereignisse aufzeichnen und in einem weiteren das Verhalten vor und nach einem Patch vergleichen.
Das funktioniert auch, wenn du einen Teil der Sitzung selbst steuern musst. Bitte Codex, die App zum Debuggen mit aktivierter Protokollierung zu starten und eine gefilterte Aufzeichnung zu beginnen. Codex soll warten, während du das Problem von Hand reproduzierst, und anschließend die gespeicherte Trace-Datei auswerten.
Praktische Tipps
Instrumentiere jeweils nur eine Funktion
Beginne mit einem einzelnen Ablauf, etwa der Auswahl in einer Seitenleiste, dem Öffnen eines Fensters, einem Befehl oder einem Synchronisierungsvorgang. So bleibt die Ereignisfolge überschaubar. Sobald dieser Ablauf zuverlässig funktioniert, kann Codex nach demselben Muster weitere, verwandte Abläufe instrumentieren.
Berücksichtige den Datenschutz im Prompt
Bitte Codex, jede protokollierte Kennung zu erläutern und weder Geheimnisse noch personenbezogene Daten oder unverarbeitete Inhalte in das zentrale Protokoll zu schreiben. Für die lokale Fehlersuche genügen meist wenige Ereignistypen.
Nimm Beispielausgaben in die abschließende Zusammenfassung auf
Anhand typischer Logzeilen lässt sich die Änderung besser nachvollziehen als anhand der Aussage „Telemetrie wurde hinzugefügt“. Bitte Codex, das Filterprädikat anzugeben und die Aktionen kurz in zeitlicher Reihenfolge aufzulisten. So kann der Agent die Prüfung beim nächsten Durchlauf wiederholen.