La règle 1-3-5 pour composer un ensemble d’Agent Skills

Le bon nombre de skills dépend de responsabilités distinctes, pas de la taille de la collection. Un pour une tâche limitée, trois pour une petite boucle d’exécution, cinq seulement pour une procédure d’équipe répétée avec planification, exécution, contrôle, preuves et maintenance séparés.

Publié le Analyse originale, sources citées

Niveau 1 : un skill pour un résultat délimité

Commencez par un skill si le travail possède une entrée, une sortie et un critère d’acceptation clairs. Une seule source et un seul périmètre de permissions sont plus faciles à comprendre, surtout pendant la première exécution contrôlée.

N’ajoutez rien tant que le premier skill porte toute la décision. Davantage d’outils ne corrige pas une tâche mal définie.

  • Un résultat concret
  • Un périmètre source
  • Un budget de permissions
  • Un contrôle d’acceptation observable

Niveau 3 : exécution, contrôle et preuves

Passez à trois uniquement si le travail soulève trois questions réellement différentes. Le rôle principal crée ou modifie le livrable. Le contrôle examine un risque connu. Le rôle de preuve démontre le comportement pertinent ou conserve un résultat reproductible.

Ces trois rôles ne doivent pas s’approuver mutuellement. Un test reste une preuve ; un contrôle statique reste un signal limité ; la décision finale reste extérieure à cet ensemble.

Niveau 5 : ajouter planification et maintenance

Cinq skills deviennent raisonnables lorsque la même procédure se répète en équipe. Ajoutez la planification pour examiner périmètre et ordre avant l’exécution. Ajoutez la maintenance pour conserver la procédure elle-même : mise à jour des sources, instructions réutilisables ou transmission documentée.

Si la planification se réduit à une phrase ou si la maintenance n’a jamais lieu, ce ne sont pas des rôles distincts. Restez à trois.

Le test de chevauchement

Écrivez une phrase décrivant la décision dont chaque skill est responsable. Si deux phrases sont pratiquement identiques, il y a chevauchement. Retirez le candidat le moins étayé ou le plus large, puis réexécutez la tâche.

Comparez aussi les permissions. Deux skills nécessitant chacun de larges accès aux commandes, au réseau et à l’écriture créent un périmètre combiné plus vaste, même si leurs descriptions semblent différentes.

  • Aucun identifiant d’installation ou paquet source en double
  • Aucune décision finale en double
  • Chaque permission supplémentaire correspond à un résultat distinct
  • Retirer un skill entraîne une perte de capacité visible

Quand réduire ou élargir l’ensemble

Réduisez après stabilisation, lorsqu’un skill personnalisé peut remplacer une coordination répétée ou quand les résultats ne sont plus examinés. Élargissez uniquement si les preuves révèlent un rôle manquant, pas parce qu’un paquet devient populaire.

Réexaminez l’ensemble après un changement de source, une migration d’agent, des échecs répétés ou une évolution de sensibilité des données. Le bon nombre peut redescendre de cinq à trois ou un.

Commencez par un skill ; justifiez les ajouts

Construisez un plan déterministe d’un à trois skills et élargissez uniquement lorsqu’une responsabilité manquante est observable.