CommunityRédaction et éditiongithub.com

RachidChabane/agentsync

Une configuration déclarative unique rendue compatible avec chaque assistant de codage IA (Claude Code, Copilot CLI, OpenCode, VS Code) + un protocole de déterminisme face à l'IA. Indépendant du LLM et du harnais.

Qu'est-ce que agentsync ?

Ce skill permet d'ajouter un nouveau harnais (harness) à agentsync, un système qui unifie la configuration des assistants de codage IA. Il transforme les concepts de configuration spécifiques à chaque harnais (Claude Code, Copilot CLI, OpenCode, VS Code) en une seule représentation déclarative, garantissant ainsi la cohérence entre tous les environnements. Le processus combine des étapes déterministes (scaffolding, détection, tests) avec des décisions de jugement basées sur la documentation officielle du harnais pour implémenter les capacités réelles comme les instructions utilisateur, la configuration MCP, le contrôle des permissions et surtout le mécanisme d'application des règles (enforcement). Le skill fournit un adaptateur automatique via un script Python, des cibles de rendu standardisées (Link, Json, Merge, HookSpec), et s'appuie sur des scripts d'application partagés pour éviter la duplication. Le résultat est un système entièrement testé et vérifié qui s'intègre proprement dans l'écosystème agentsync.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓OpenCode✓Windsurf
npx skills add RachidChabane/agentsync

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 enforcement en dehors de capabilities().

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.

Skills associés