Écrire une compétence
Cette exécution crée ou retravaille une compétence. Le résultat est jugé par le comportement lors de l'exécution, non par sa lecture : cette exécution installe le processus de l'utilisateur, pas un modèle générique de compétence.
Avant d'écrire, suivez le pointeur de contexte dans reference.md — la mécanique du frontmatter s'y trouve.
Étapes
- Corriger le déclencheur. Demandez qui doit atteindre la compétence et quand. Une compétence qui ne s'exécute jamais que sur demande est invoquée par l'utilisateur (
disable-model-invocation: true, la description devient un résumé humain d'une ligne, <100 caractères). Une compétence que l'agent doit atteindre spontanément est invoquée par le modèle : sa description est le pointeur toujours chargé, et son libellé décide si le déclenchement se produit. Terminé quand : le choix d'invocation nomme la charge qu'il paie — le contexte, ou votre mémoire. - Inventorier comment le travail s'exécute réellement. Rappelez-vous la dernière exécution réelle de ce travail : ce qui a été renvoyé, corrigé ou répété. Ces corrections constituent le contenu de la compétence ; ce que le modèle fait sans aide ne l'est pas. Terminé quand : le brouillon cite au moins un échec réel qu'il empêche.
- Rédiger les étapes, puis les pointeurs. Chaque étape est une procédure avec une condition d'achèvement explicite, ordonnée de manière à ce que l'exécution livre d'abord quelque chose de vérifiable. Le matériel de soutien dont seuls certains passages ont besoin va dans
reference.mdderrière un pointeur nommant quand le lire. Terminé quand : chaque étape est vérifiable sans demander à l'agent si elle a réussi. - Choisir les mots directeurs. Pour chaque idée récurrente, prenez le mot compact qui existe déjà dans le pré-entraînement du modèle et laissez-le porter le sens : les pointeurs, les étapes et les conditions d'achèvement réutilisent ces mots. Renommez le jargon en ces mots plutôt que de l'expliquer. Terminé quand : chaque mot directeur apparaît à plus d'un endroit et oriente dans chacun.
- Élaguer avec le test de non-opération. Phrase par phrase : supprimez-la, demandez ce qui s'est cassé. Rien n'est cassé — la phrase disparaît. Les phrases entières sont supprimées, jamais des mots raccourcis ; la duplication s'effondre en une source unique de vérité plutôt qu'en deux estompages. Terminé quand : vous ne pouvez plus exécuter le test de non-opération sans passages ; le fichier est plus court que la version précédente.
Référence
- reference.md — mécanique du frontmatter par type d'invocation, les règles d'écriture des pointeurs et la batterie de checklist pour réviser une compétence existante.
- La compétence que produit cette exécution est itérée sur des exécutions réelles, pas écrite une fois : lorsqu'une exécution se comporte mal, la référence de lecture qualifie l'échec avant toute réécriture.