Aperçu moduleModule previewVista previa del módulo
Aperçu limité, 3 premières étapesLimited overview, first 3 stepsVisibilidad limitada, 3 primeras etapas

Les compétencesSkillsLas competencias

Parcours : Construire un agent de code, le harnais · OpérationnelCourse: Building a Coding Agent: the Harness · PractitionerCurso: Construir un agente de código: el harness · Operativo

Les compétences
1/7
ÉtapeStepEtapa 1 / 7

≈ 9 min

Le problème

Le problème : pour que l’agent respecte les conventions du projet, la solution évidente est de toutes les lui donner, à chaque appel, même celles qui ne servent pas.

Au programme de ce moduleIn this moduleEn el programa de este módulo

  1. 01Le problème≈ 9 min
  2. 02L’intuition≈ 8 min
  3. 03Le mécanisme≈ 9 min
  4. 04Le code, pas à pas≈ 10 min
  5. 05Pièges & pratiques≈ 10 min
  6. 06Exercice≈ 6 min
  7. 07Quiz≈ 5 min
Durée totaleTotal durationDuración total≈ 57 min
voix de synthèse

Objectifs d’apprentissage

À la fin de ce module, vous saurez donner à votre agent des connaissances spécialisées qu’il ne charge qu’au moment où une tâche en a besoin. Voici les acquis visés.

  • Expliquer pourquoi des instructions toujours présentes coûtent à chaque appel, même quand elles ne servent pas ;
  • Organiser des compétences en dossiers, chacune décrite par un fichier SKILL.md à en-tête YAML ;
  • Coder un catalogue léger, toujours visible du modèle, et un outil load_skill qui charge le contenu complet à la demande, par son nom ;
  • Écrire des descriptions qui déclenchent le bon chargement, et traiter une compétence comme du code : relue, concise, de source sûre.

Sources

Curriculum open-source shareAI-lab/learn-claude-code, chapitre s07 (Skill Loading), publié sous licence MIT, © shareAI-lab, adaptation Getul. La notice de licence est reproduite sur la page Sources et références. Documentation publique de Claude Code (Anthropic) sur les compétences (skills), citée pour comparer avec un outil en production. Le motif présenté est indépendant du fournisseur : il vaut pour toute API offrant l’appel d’outils.

Tout dire, tout le temps

Votre projet a ses règles : une charte de revue de code, des conventions de tests, un guide des requêtes SQL. Vous voulez que l’agent les respecte. Le réflexe est de les lui donner toutes, d’emblée, dans un prompt système.

SYSTEM = (
    "Tu es un agent de code. Respecte ces règles :\n"
    + open("docs/revue-de-code.md").read()
    + open("docs/conventions-tests.md").read()
    + open("docs/guide-sql.md").read()
)
Trois documents complets envoyés à chaque appel, quelle que soit la tâche.

Cela fonctionne, et cela coûte. Le prompt système repart au modèle à chaque appel : quand la tâche est de corriger un test, le guide SQL et la charte de revue voyagent quand même, en tokens et en place dans la fenêtre de contexte. Avec trois documents, c’est supportable ; avec trente, la moitié du contexte est occupée par des règles qui ne servent pas, et l’essentiel s’y dilue, comme au module 5.

Pour comprendre : le classeur de procédures

Un technicien ne relit pas chaque matin toutes les procédures de l’atelier. Il connaît le sommaire du classeur, et quand une intervention le demande, il ouvre la bonne fiche. Votre agent a besoin de la même chose : le sommaire en permanence, la fiche complète au moment où elle sert.

Vérifiez votre compréhensionCheck your understandingVerifique su comprensión

Les trois guides du projet sont dans le prompt système. L’agent corrige un test pendant vingt tours. Combien de fois le guide SQL est-il envoyé au modèle ?

À retenir

Des instructions toujours présentes coûtent à chaque appel et encombrent le contexte, même quand elles ne servent pas. Il faut séparer ce que l’agent doit toujours savoir (qu’une règle existe) de ce qu’il ne doit lire qu’au besoin (la règle elle-même).