Einen Harness zu agentsync hinzufügen
Das Hinzufügen eines Harness ist Beurteilungsarbeit (Abbildung der Konzeptedes Harness-Konfiguration), umgeben von einem deterministischen Gerüst. Führen Sie die Schritte in der angegebenen Reihenfolge aus; überspringen Sie nicht das Lesen der Dokumentation.
1. Prüfen, ob es bereits behandelt wird
Sehen Sie in core/adapters/__init__.py (ADAPTERS) und config/profile.json nach. Wenn der Harness dort bereits vorhanden ist, brechen Sie ab – es gibt nichts hinzuzufügen.
2. Gerüst des Adapters erstellen (deterministisch)
python3 skills/add-harness/scaffold-adapter.py <name>
Dies schreibt core/adapters/<name>.py (als Vorlage) und registriert ihn. Es kennt den Harness NICHT – das füllen Sie im nächsten Schritt aus.
3. Dokumentation des Harness lesen (die Beurteilung – nicht raten)
Ermitteln und bestätigen Sie anhand der eigenen Dokumentation des Harness:
- Instruktionen – Liest er eine Anweisungs-/Regeldatei für den Benutzerbereich? Wo? (Falls nur inline in den Einstellungen, spiegeln Sie den Ansatz von VS Code wider.)
- MCP – Sein MCP-Konfigurationsformat und Dateispeicherort (oder dass es keinen gibt).
- Skills/Berechtigungen – irgendeine Kontrolle der Skill-Verfügbarkeit (oder keine).
- Erzwingung (Hooks) – der knifflige Teil: Kann er vor einem Toolaufruf einen Befehl ausführen? Welches JSON erhält der Hook über stdin (der Befehlsfeldname)? Wie signalisiert er "Blockieren"? Wenn er keine Hook-Oberfläche hat, aber ein Plugin-System besitzt, spiegeln Sie OpenCode's Plugin wider. Wenn er überhaupt nicht erzwingen kann, lassen Sie
enforcementauscapabilities()weg.
4. Adapter ausfüllen
Implementieren Sie capabilities() (ehrlich – nur das, was der Harness tatsächlich unterstützt) und targets() unter Verwendung der vorhandenen Zieltypen (Link, Json, Merge, HookSpec). Verwenden Sie die gemeinsam genutzten core/enforcement/guard-commit.sh und session-nudge.sh wieder – weisen Sie den Hook des Harness gemäß seinem Vertrag darauf hin; implementieren Sie das Gate nicht neu. Behalten Sie extra_owned/extra_hooks von self._passthrough(ctx) bei, damit die Durchleitung der Einstellungen funktioniert.
5. Erkennung + Test + Verifikation
- Fügen Sie eine Erkennungszeile dafür in
init.shhinzu. - Fügen Sie Assertionen zu
tests/test_apply.pyhinzu (seine Dateien werden im Sandbox korrekt gerendert). - Führen Sie
make verifyaus. Es muss bestehen, bevor Sie fertig sind.
Referenz
core/adapters/claude.py (voll ausgestattet) und vscode.py (nur Instruktionen, verwendet die Hooks eines anderen Harness wieder) sind die beiden Enden des Spektrums, von denen Sie kopieren können.