Lecture de compétences (ReadSkillTool)

Présentation

L'outil de lecture de compétences permet à un agent de consulter les instructions détaillées contenues dans les compétences qui lui sont assignées. Une compétence est un document en Markdown qui décrit une procédure, un savoir-faire ou un ensemble de règles que l'agent doit suivre pour accomplir un type de tâche précis.

Cet outil est invisible dans l'interface : il est injecté automatiquement dès qu'un agent possède au moins une compétence assignée. L'utilisateur n'a pas besoin de l'activer manuellement.

Fonctionnement

Injection automatique

Lorsqu'un agent démarre un flux de travail et qu'il possède des compétences assignées, l'outil est ajouté silencieusement à sa liste d'outils. Le prompt système de l'agent est enrichi d'une section listant les compétences disponibles, avec pour chacune son nom.

Référence dans les prompts

Les prompts peuvent contenir des références à des compétences via la syntaxe {{skill:nom}}. Lors de l'exécution, cette référence est automatiquement remplacée par une instruction demandant au modèle de lire la compétence avant de poursuivre. Le modèle appelle alors l'outil pour récupérer le contenu complet.

Opérations disponibles

Lister

Affiche toutes les compétences accessibles à l'agent : nom, description et catégorie. Seules les compétences assignées à l'agent et activées sont retournées.

Lire

Récupère le contenu complet d'une compétence par son nom. L'agent ne peut lire que les compétences qui lui sont assignées — toute tentative de lecture d'une compétence non assignée est refusée.

Catégories de compétences

Les compétences sont organisées en cinq catégories :

  • Système — Règles et procédures internes de l'application
  • Code — Conventions de développement, patterns et bonnes pratiques
  • Flux de travail — Procédures étape par étape pour des tâches complexes
  • Analyse — Méthodes d'analyse, de diagnostic ou d'évaluation
  • Personnalisée — Toute compétence ne relevant pas des catégories précédentes

Contrôle d'accès

Chaque agent ne peut consulter que les compétences figurant dans sa liste d'assignation, configurée dans ses paramètres. Ce cloisonnement garantit que chaque agent n'accède qu'aux instructions pertinentes pour son rôle.

Les compétences désactivées sont traitées comme inexistantes : elles n'apparaissent ni dans la liste ni dans les résultats de lecture.

Limites

  • Nom : 128 caractères, uniquement lettres, chiffres, tirets et tirets bas
  • Description : 500 caractères maximum
  • Contenu : 50 000 caractères maximum (format Markdown)

Fonctionnement

L'outil est injecté automatiquement et s'intègre au cycle prompt-exécution de l'agent.

Injection automatique

L'outil est ajouté silencieusement dès que l'agent possède au moins une compétence assignée. Le prompt système liste les compétences disponibles.

Référence dans les prompts

La syntaxe {{skill:nom}} dans un prompt est remplacée par une instruction de lecture automatique lors de l'exécution.

Dans le prompt {{skill:code-review}}
Instruction générée Lire la compétence « code-review » via ReadSkill avant de poursuivre

Opérations

L'outil expose deux opérations simples pour découvrir et consulter les compétences.

Lister

Nom, description et catégorie de chaque compétence assignée et activée

Lire

Contenu Markdown complet d'une compétence par son nom

Catégories

Les compétences sont organisées en cinq catégories pour faciliter leur classification.

Système Règles et procédures internes
Code Conventions et bonnes pratiques
Flux de travail Procédures étape par étape
Analyse Méthodes de diagnostic
Personnalisée Tout autre type

Contrôle d'accès

Chaque agent n'accède qu'aux compétences qui lui sont explicitement assignées.

Agent « Développeur »
code-review
testing-strategy
data-analysis non assignée
Les compétences désactivées dans les paramètres sont invisibles pour l'agent : elles n'apparaissent ni dans la liste ni dans les résultats de lecture.

Limites

Paramètre
Limite
Nom
128 caractères (lettres, chiffres, tirets, tirets bas)
Description
500 caractères
Contenu
50 000 caractères (Markdown)
Opérations
2 (lister, lire)
Visibilité
Outil invisible, injection automatique