writing-for-agents
Référence pour rédiger tout document consommé par un agent : un skill, AGENTS.md ou un document atteint par un pointeur. Le contenant change, mais les principes d’écriture restent les mêmes : ils rendent le processus suivi par l’agent prévisible sans imposer un résultat identique à chaque exécution.
Lorsque le document que vous rédigez est une compétence, lisez SKILL-MECHANICS.md pour connaître le contenu, le choix d'invocation et les compétences de routeur.
Pointeurs de contexte
Un pointeur de contexte est une référence contenue dans le contexte de l'agent qui nomme du matériel hors contexte et code la condition pour l'atteindre. La description d'une compétence en est une ; une ligne dans AGENTS.md nommant un document est le même objet. C'est la formulation du pointeur, et non sa cible, qui décide du moment où l'agent atteint le matériau – et avec quelle fiabilité. Une cible incontournable derrière un pointeur faiblement formulé est un bogue de variance : aiguisez d'abord le texte, et insérez le contenu uniquement si la netteté échoue.
Un pointeur effectue deux tâches : indiquer quel est le matériau et répertorier les branches qui devraient déclencher son atteinte (une branche est un cas distinct que le document gère, donc différentes exécutions empruntent des chemins différents à travers elle). Chaque mot d'un pointeur toujours chargé coûte à chaque tour, il gagne donc un élagage encore plus dur que le corps :
- Chargez en premier le mot principal — le pointeur est l'endroit où il effectue son travail de déclenchement.
- Un déclencheur par branche. Les synonymes qui renomment une seule branche sont une branche écrite deux fois ; réduisez-les et ne conservez que des branches véritablement distinctes.
- Identité coupée que le corps porte déjà.
Les deux charges
Chaque document et pointeur que vous ajoutez dépense l'un des deux budgets suivants :