Wanbicoi/agent-config

L'utilisateur a demandé une rétrospective. Vous suggérez des améliorations pour l'environnement de l'agent de codage afin d'améliorer les exécutions futures.

Étapes

1. Appelez l'outil Skill avec writing-for-agents pour le guide de style d'écriture.

2. Lisez les sources principales de la session que l'utilisateur spécifie. Cela peut impliquer de chercher dans les journaux de session sur cette machine. Si l'utilisateur ne spécifie pas de session, utilisez la session courante par défaut.

3. Recherchez des candidats à l'amélioration dans ces catégories.

• Navigation : dans quelle mesure était-il facile pour l'agent de trouver les bons fichiers ? Existe-t-il des dépendances cachées entre les fichiers ? Un pointeur de navigation faciliterait-il les choses ? À utiliser lorsque la session a pris beaucoup de temps pour trouver une information.
• Vérifications automatisées : existe-t-il des vérifications automatisées qui pourraient détecter les erreurs commises par l'agent ? Linting, typage, tests, linters de système de fichiers ? Lisez d'abord la commande de vérification propre au dépôt (ses scripts lint/check dans package.json/outil de build, son workflow CI), afin qu'une vérification qui existe déjà mais qui est déconnectée ou silencieusement cassée constitue la constatation, et non une réinvention. Un dépôt sans garde-fou (aucun hook pre-commit et aucun job CI exécutant sa commande lint/typecheck/test) est en soi une constatation : un dépôt non linté est une opportunité manquée permanente, pas un état neutre par défaut. À utiliser lorsque l'agent a commis une erreur qu'une vérification automatisée aurait pu détecter, ou que le dépôt n'a aucun garde-fou.
• Standards de codage : l'agent relecteur devrait-il recevoir une nouvelle règle à appliquer ? Une règle existante devrait-elle être supprimée ou clarifiée ? Classez d'abord la violation : une violation mécanique (un motif syntaxique fixe, une API interdite, une forme d'import, une règle d'emplacement de fichier) reçoit une vérification déterministe, point final : une règle personnalisée dans le linter du dépôt, un nouveau hook pre-commit, ou un nouveau job CI, selon ce qui est le moins coûteux pour le langage du dépôt et ses garde-fous existants. Par défaut, construisez la vérification plutôt que d'écrire la règle. Réservez CODING_STANDARDS.md pour les véritables décisions subjectives (cohérence entre fichiers, « correspond au style environnant », tout ce qu'aucun garde-fou ne pourrait jamais remplacer). À utiliser lorsque l'agent relecteur n'a pas détecté une erreur.
• AGENTS.md global : existe-t-il des instructions d'orientation qui devraient être déplacées vers les standards de codage (ou les vérifications automatisées) à la place ? À utiliser lorsque le fichier AGENTS.md est particulièrement volumineux – dans le dépôt OU dans le scope global de l'utilisateur.
• Économie d'outils : l'agent a-t-il effectué des appels d'outils coûteux qui pourraient être optimisés ? Existe-t-il des outils personnalisés (CLI, MCP) qui sont particulièrement inefficaces en termes de tokens ? À utiliser lorsque l'agent a effectué un appel d'outil coûteux.
• Sans effet : recherchez dans les fichiers d'orientation des instructions qui ne modifient pas le comportement de l'agent. À utiliser lorsque les fichiers d'orientation sont volumineux et difficiles à manipuler.
• Accès à l'information : cherchez des opportunités pour augmenter l'accès de l'agent à l'information. Téer les logs du serveur de développement, accès en lecture seule à des services tiers. À utiliser lorsque une information cruciale n'était pas disponible pour l'agent.

4. Présentez ces candidats à l'utilisateur, par ordre de sévérité.

Référence

Implémentation vs Relecture

Rappelez-vous que tout travail passe par deux étapes : l'implémentation et la relecture. L'agent d'implémentation subit la plus forte pression de contexte. Il est responsable de l'exploration, de l'écriture du code et du débogage des échecs.

L'agent relecteur subit le moins de pression de contexte – il reçoit un diff, donc aucune exploration n'est nécessaire. Il n'a souvent pas besoin d'écrire du code ou de déboguer.

Cela signifie que l'agent relecteur devrait être responsable de l'imposition des standards de codage, et non l'agent d'implémentation.

Fichiers

Vous avez accès à plusieurs fichiers dans le dépôt :

• CLAUDE.md/AGENTS.md : ces fichiers sont poussés dans la fenêtre de contexte de tout agent travaillant dans ce dépôt. Ils doivent être utilisés avec une extrême parcimonie, généralement uniquement pour des pointeurs de navigation vers d'autres fichiers.
• CODING_STANDARDS.md : ce fichier est lu pendant la relecture, pas pendant l'implémentation. Ajoutez des pointeurs de navigation vers des dossiers de documentation si le fichier de standards dépasse 1 000 lignes.
• Documentation : utilisez la documentation comme fichiers de référence, pointés par d'autres fichiers. Cherchez la documentation existante avant d'en écrire une nouvelle.
• Skills : utilisez les skills pour la documentation (car leur description est injectée dans la fenêtre de contexte de l'agent), ou pour des commandes invoquées par l'utilisateur. Suivez les conseils du skill writing-for-agents.