Eujenz/collaborative-agent-harness

Was macht collaborative-agent-harness?

Codex-Fähigkeit und Arbeitsvorlage für agentengestützte Entwicklung, Checkpoints, Git-Hygiene und Sitzungsübergabe.

Übersicht

Diese Fähigkeit stellt eine wiederverwendbare Vorlage und Anleitung für die Zusammenarbeit mit einem KI-Agenten (z.B. Codex) bereit. Sie hilft dabei, komplexe Aufgaben in handhabbare Schritte zu unterteilen, den Fortschritt durch Git-Commits zu dokumentieren und die Arbeit zwischen Entwickler und Agent effizient zu übergeben.

Kernkonzepte

• Rollen: Definiert die Rolle des Agenten (z.B. „erfahrener Entwickler“) für einen konsistenten Kontext.
• Aufgabenliste: Verwendet eine TODO.md oder ähnliche Markdown-Datei, um Aufgaben, deren Status und Abhängigkeiten zu verfolgen.
• Checkpoints: Regelmäßige, sinnvolle Git-Commits dienen als Checkpoints, zu denen bei Bedarf zurückgekehrt werden kann.
• Sitzungsübergabe: Ein klares Protokoll (oft in HANDOFF.md oder den Commits selbst) dokumentiert den aktuellen Stand, offene Fragen und nächste Schritte, falls eine Sitzung unterbrochen wird.
• Git-Hygiene: Befolgt Best Practices wie klare Commit-Nachrichten, kleine, fokussierte Commits und das Vermeiden von unnötigen Änderungen.

Verwendung

1. Initialisierung: Lege ein neues Verzeichnis an oder verwende ein bestehendes Git-Repository.
2. Aufgaben laden: Erstelle oder aktualisiere die Aufgabenliste (TODO.md) mit den anstehenden Arbeiten.
3. Sitzung starten: Weise den Agenten an, die Aufgabenliste zu lesen und mit der Arbeit zu beginnen. Die Rollendefinition aus dieser Fähigkeit wird dem Agenten bereitgestellt.
4. Arbeiten und Committen: Der Agent arbeitet die Aufgaben ab und erstellt regelmäßig Git-Commits als Checkpoints. Jeder Commit sollte eine aussagekräftige Nachricht haben.
5. Übergabe: Bei Sitzungsende (oder Unterbrechung) aktualisiert der Agent die Aufgabenliste und dokumentiert den Fortschritt für die nächste Sitzung.

Dateistruktur (Beispiel)

mein-projekt/
├── .git/
├── README.md
├── TODO.md          # Aktuelle Aufgabenliste
├── HANDOFF.md       # Notizen zur Sitzungsübergabe (optional)
└── ...              # Quellcode und andere Dateien

Voraussetzungen

• Ein Git-Repository.
• Ein Codex-kompatibler KI-Agent.
• Grundkenntnisse in Git und der Arbeit mit KI-Agenten.

Lizenz

Diese Vorlage steht unter der MIT-Lizenz zur Verfügung. Siehe die Datei LICENSE (falls vorhanden) für Details.