Ajouter un harnais à agentsync
Ajouter un harnais est un travail de jugement (mapping des concepts de configuration du harnais) enveloppé autour d'un scaffold déterministe. Suivez les étapes dans l'ordre ; ne sautez pas la lecture de la documentation.
1. Vérifiez qu'il n'est pas déjà géré
Regardez dans core/adapters/__init__.py (ADAPTERS) et config/profile.json. Si le harnais s'y trouve, arrêtez-vous — il n'y a rien à ajouter.
2. Créez l'adaptateur (déterministe)
python3 skills/add-harness/scaffold-adapter.py <nom>
Ceci écrit core/adapters/<nom>.py (avec un squelette) et l'enregistre. Il ne connaît PAS le harnais — vous le remplissez à l'étape suivante.
3. Lisez la documentation du harnais (le jugement — ne devinez pas)
Trouvez et confirmez, à partir de la documentation officielle du harnais :
- Instructions — lit-il un fichier d'instructions/règles au niveau de l'utilisateur ? Où ? (Si seulement en ligne dans les paramètres, reproduisez l'approche de VS Code.)
- MCP — son format de configuration MCP et son emplacement de fichier (ou qu'il n'en a pas).
- Compétences/permissions — tout contrôle de disponibilité des compétences (ou rien).
- Application (hooks) — la partie délicate : peut-il exécuter une commande avant un appel d'outil ? Quel JSON le hook reçoit-il sur stdin (le nom du champ de commande) ? Comment signale-t-il un « blocage » ? S'il n'a pas de surface de hook mais possède un système de plugins, reproduisez le plugin d'OpenCode. S'il ne peut rien appliquer du tout, laissez
enforcementen dehors decapabilities().
4. Remplissez l'adaptateur
Implémentez capabilities() (honnêtement — seulement ce que le harnais supporte réellement) et targets() en utilisant les types de cibles existants (Link, Json, Merge, HookSpec). Réutilisez les scripts partagés core/enforcement/guard-commit.sh et session-nudge.sh — pointez le hook du harnais vers eux selon son contrat ; ne réimplémentez pas la porte. Conservez extra_owned/extra_hooks de self._passthrough(ctx) pour que le passage des paramètres fonctionne.
5. Détection + test + vérification
- Ajoutez une ligne de détection pour ce harnais dans
init.sh. - Ajoutez des assertions dans
tests/test_apply.py(ses fichiers sont rendus correctement dans le bac à sable). - Exécutez
make verify. Cela doit réussir avant que vous ayez terminé.
Référence
core/adapters/claude.py (complet) et vscode.py (instructions uniquement, réutilise les hooks d'un autre harnais) sont les deux extrémités du spectre à copier.