Communitygithub.com

MrBinnacle/skill-harness

Tests différentiels par ablation de clauses pour les compétences LLM. Mesure si chaque clause d'un artefact de compétence produit un effet directionnel mesurable. Pré-alpha.

Qu'est-ce que skill-harness ?

MrBinnacle/skill-harness est un outil de test différentiel par ablation de clauses, conçu pour les compétences d'agents LLM comme Claude Code, Cursor ou Codex. Il permet de déterminer quantitativement si une clause spécifique (instruction, règle ou paramètre) dans un fichier SKILL.md (ou équivalent) a un impact réel sur le comportement du modèle. L'outil fonctionne en supprimant (ablation) chaque clause une par une, puis en mesurant l'effet directionnel sur un ensemble de scénarios de test prédéfinis. Cela permet aux développeurs d'identifier les clauses redondantes ou inefficaces, d'optimiser les compétences et de garantir que chaque partie de l'artefact contribue de manière significative. L'outil est actuellement en pré-alpha et prend en charge les agents implémentant des compétences sous forme de fichiers Markdown structurés. Il est particulièrement utile pour l'ingénierie de prompts et l'optimisation de performances des assistants IA.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add MrBinnacle/skill-harness

Demander à votre IA préférée

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

Documentation

Que fait skill-harness ?

Tests différentiels par ablation de clauses pour les compétences LLM. Mesure si chaque clause d'un artefact de compétence produit un effet directionnel mesurable. Pré-alpha.

Description

Ce dépôt fournit un cadre de test pour analyser les compétences (skills) des agents LLM en effectuant des ablations systématiques de chaque clause. L'objectif est de déterminer si une clause individuelle contribue de manière significative au comportement attendu de l'agent.

Utilisation

pip install -r requirements.txt
python harness.py --skill chemin/vers/skill.md --tests dossier/tests/

Arguments

  • --skill : Chemin vers le fichier SKILL.md à tester.
  • --tests : Dossier contenant les scénarios de test (format JSON).
  • --output : (Optionnel) Fichier de sortie pour les résultats.

Fonctionnement

  1. Le fichier de compétence est parsé en clauses individuelles (chaque paragraphe, règle ou instruction).
  2. Pour chaque clause, une version sans cette clause est générée.
  3. Chaque version est exécutée sur les scénarios de test.
  4. Les résultats sont comparés à la version complète pour mesurer l'effet directionnel.
  5. Un rapport est généré indiquant les clauses ayant un impact significatif, négligeable ou nul.

Exemple de rapport

Clause 1 : "Réponds toujours en français" -> Effet fort (comportement modifié)
Clause 2 : "Utilise le style formel" -> Effet modéré
Clause 3 : "Évite les listes" -> Effet négligeable (peut être supprimé)

Statut

Pré-alpha. L'API et le format de sortie peuvent changer sans préavis. Les tests ne couvrent pour l'instant que des agents basés sur des fichiers Marklin. Les contributions sont les bienvenues.

Licence

MIT

Skills associés