CommunitySchreiben & Editierengithub.com

RachidChabane/agentsync

Eine deklarative Konfiguration, die in jedem KI-Coding-Assistenten (Claude Code, Copilot CLI, OpenCode, VS Code) gerendert wird, plus ein Determiniertheits-vs-KI-Erzwingungsprotokoll. LLM- und Harness-unabhängig.

Was ist agentsync?

Dieses Skill ermöglicht es Entwicklern, eine einzige deklarative Konfigurationsdatei zu definieren, die automatisch in mehrere KI-Coding-Assistenten wie Claude Code, Copilot CLI, OpenCode und VS Code integriert wird. Es bietet ein neuartiges Determiniertheitsprotokoll, das die Ausführung von KI-gesteuerten Tools kontrolliert und erzwingt – ähnlich wie ein deterministischer Sicherheitsmechanismus für KI-Agenten. Der Skill ist LLM- und Harness-unabhängig, d.h. er funktioniert mit verschiedenen KI-Modellen und Entwicklungsumgebungen. Er verwendet ein Adapter-basiertes System, um die Konfigurationen verschiedener Assistenten zu normalisieren und zu synchronisieren, was die Entwicklungsumgebung konsistent und vorhersehbar hält.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor✓OpenCode✓Windsurf
npx skills add RachidChabane/agentsync

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 enforcement aus capabilities() 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.sh hinzu.
  • Fügen Sie Assertionen zu tests/test_apply.py hinzu (seine Dateien werden im Sandbox korrekt gerendert).
  • Führen Sie make verify aus. 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.

Verwandte Skills