sfalasca/agent-context-kit

Que fait agent-context-kit ?

Trois compétences portables pour agent qui offrent à un agent de codage un contexte persistant et découvrable sur une base de code : conventions (directives), procédures opérationnelles (guides) et automatisation existante (scripts) au lieu de les redécouvrir ou réinventer à chaque session. Format ouvert de compétences pour agent ; fonctionne avec Claude Code, Codex, Cursor et d'autres.

Compétences

1. Conventions de codage (conventions/)

• Quoi : Directives de style, modèles et règles spécifiques à ce projet que l'agent était censé déduire.
• Rôle : L'agent lit des fichiers comme code-style.md ou pull-request.md dès le départ.
• Maintenance : L'agent met à jour conventions/ lorsqu'il détecte une règle récurrente, puis explique le changement à l'utilisateur.

2. Procédures opérationnelles (how-tos/)

• Quoi : Procédures pour lancer une application, exécuter des migrations, configurer une connexion VPN, etc.
• Rôle : L'agent exécute des étapes réutilisables au lieu de demander comment faire.
• Maintenance : L'agent crée un how-to pour toute procédure qu'il répète ou pour laquelle on lui demande de se souvenir. Il explique également tout comme conventions/.

3. Scripts et automatisation (scripts/)

• Quoi : Scripts autonomes du projet (utilitaires de déploiement, migrations de base de données, outils de transformation de code).
• Rôle : L'agent exécute ces scripts comme un développeur le ferait, plutôt que de récrire une logique ad hoc.
• Interaction : L'agent peut exécuter des scripts, lire leur sortie, et s'il détecte des scripts manquants, il peut suggérer de les créer.

Utilisation pour l'agent

Lors de chaque nouvelle session, l'agent doit :

1. Lire les fichiers sous conventions/, how-tos/ et scripts/.
2. Expliquer à l'utilisateur le contexte qu'il a chargé et comment l'utiliser.
3. Agir en fonction des conventions et des guides trouvés.
4. Mettre à jour ou créer de nouveaux fichiers pertinents selon les besoins, en informant toujours l'utilisateur.

Comment configurer ce kit dans votre projet

• Copiez les trois répertoires (conventions/, how-tos/, scripts/) dans la racine de votre projet.
• Placez les fichiers SKILL.md de chaque compétence dans le répertoire correspondant.
• Optionnellement, créez un fichier skill.json ou SKILL.md racine pointant vers les trois.

Structure des répertoires

project-root/
  ├── conventions/
  │   ├── SKILL.md
  │   ├── code-style.md
  │   └── pull-request.md
  ├── how-tos/
  │   ├── SKILL.md
  │   ├── run-app.md
  │   └── migrate-db.md
  └── scripts/
      ├── SKILL.md
      ├── deploy.sh
      └── seed-data.sh

Remarques importantes

• L'agent doit toujours expliquer à l'utilisateur ce qu'il a chargé et pourquoi.
• L'agent doit éviter de dupliquer le contenu entre les fichiers de contexte.
• Lorsque l'agent crée un nouveau fichier de contexte, l'utilisateur doit en être informé et une approbation peut être demandée.
• L'agent peut exécuter des scripts, mais il doit être prudent avec les scripts destructeurs (par exemple, migrations de base de données).

Licence

MIT – libre d'utilisation et de modification.

---

Créé par sfalasca. Soumettez des issues ou des PRs pour améliorer le kit.