Agents, skills, instructions et prompt files

Quand un même type de demande revient souvent, il devient utile de sortir du simple prompt copié-collé. Cette page sert à distinguer quatre briques complémentaires : les instructions de projet, les prompt files, les agents personnalisés et les skills documentées.

L'objectif est d'industrialiser l'usage de l'IA sans perdre la maîtrise : mieux cadrer les réponses, mieux limiter les droits, mieux versionner les pratiques et mieux transmettre un mode opératoire à une équipe.

Dans certains outils, on parlera explicitement de custom agents. L'idée reste la même : spécialiser un rôle, encadrer son comportement et calibrer ses droits sur un besoin récurrent.

Quand utiliser quoi

• Instructions de projet : quand les mêmes règles doivent s'appliquer partout dans le workspace.
• Prompt file : quand un cas d'usage revient souvent avec une structure stable.
• Agent personnalisé : quand vous voulez un rôle spécialisé avec une posture claire et des droits bien calibrés.
• Skill : quand vous voulez transmettre une méthode plus complète, avec ressources, exemples, arbre de fichiers ou scripts annexes.

Exemple d'instructions de projet

# .github/copilot-instructions.md
- Réponds en français.
- Sépare analyse, plan, implémentation et validations.
- Pour une modification risquee, commence par un plan.
- Ne modifie pas l'API publique sans le signaler.
- Termine par les risques restants et les vérifications manuelles.

Ces instructions servent de socle. Elles doivent rester courtes, stables et faciles à relire. Ce n'est pas l'endroit pour mettre tout votre savoir-faire métier en vrac.

Exemple de bibliothèque de prompt files

prompts/
  plan-tests.md
  plan-refactor.md
  revue-securite.md
  doc-technique.md
  migration-js-ts.md

L'idée est simple : garder vos formulations utiles dans des fichiers versionnés, les relire, les faire évoluer et les réutiliser plutôt que de repartir de zéro à chaque fois.

Dans ce workspace, ces prompt files peuvent reprendre la logique déjà présente dans les pages IA : tests, refactor, revue sécurité, documentation et migration progressive.

Exemple de skill ou compétence documentée

mon-skill/
  skill.md
  resources/
    exemples.md
    checklist.md
  scripts/
    verifier.ps1
  docs/
    usage.md

Une structure comme celle-ci permet de rassembler la consigne principale, des ressources de contexte, des exemples réutilisables et, si besoin, des scripts ou validations qui soutiennent la méthode.

Ce qu'un fichier skill.md doit expliciter

• But : le problème que la skill aide à traiter.
• Quand l'utiliser : signaux concrets qui justifient son usage.
• Entrées attendues : fichiers, logs, contexte, type de demande.
• Sorties visées : plan, patch, checklist, note de synthèse, arbre de solutions.
• Limites : ce que la skill ne couvre pas ou ne doit pas faire.
• Dépendances : ressources, scripts, prérequis techniques ou humains.

Frontmatter possible :
name: qa-flux
description: Construire des plans de tests de flux et de non-régression.
inputs: endpoints, fichiers JSON, cas limites
outputs: plan, jeux de données, validations
tools: lecture, écriture limitée

Custom agents / agents personnalisés : rôle, instructions, tools set

Un agent personnalisé combine généralement trois choses : un rôle clair, des instructions adaptées et un niveau d'accès pertinent. Un agent documentation n'a pas besoin des mêmes droits qu'un agent de refactor ou qu'un agent QA qui doit vérifier plusieurs fichiers.

• Agent doc : très bon pour plans, restructuration, synthèses et guides internes.
• Agent QA : utile pour construire jeux de tests, cas limites, validations et non-régression.
• Agent sécurité : spécialisé pour entrée utilisateur, secrets, erreurs exposées et contrôle d'accès.

Trio simple pour démarrer

Workflow simple de création

1) Isoler un besoin récurrent.
2) Écrire le cadre minimal : rôle, but, entrées, sorties, limites.
3) Ajouter des ressources ou exemples si besoin.
4) Tester sur 2 ou 3 cas réels.
5) Corriger les ambiguïtés.
6) Versionner et documenter l'usage.
7) Empaqueter ou partager quand c'est stable.

Si vous diffusez une skill hors du projet, prévoyez un packaging propre, par exemple une archive ZIP ou un dépôt dédié, avec README, exemples et tests de vérification minimaux.

Prompts rapides selon le besoin

• Écrire des instructions de projet : "Propose un fichier d'instructions court pour ce workspace, en séparant style, contraintes, validations et interdits."
• Créer un prompt file : "Transforme ce cas récurrent en prompt file versionnable, avec objectif, entrées attendues et format de sortie imposé."
• Définir un agent : "Conçois un agent spécialisé pour cette tâche, avec rôle, limites, droits nécessaires et exemples de sorties."
• Structurer une skill : "Propose l'arborescence minimale d'une skill avec skill.md, ressources, exemples et scripts utiles, puis explique le rôle de chaque fichier."
• Vérifier avant diffusion : "Relis cet agent ou cette skill et liste les ambiguïtés, les droits trop larges et les validations manquantes avant partage."

Checklist avant diffusion

• Le but est-il nommé en une phrase simple ?
• Les entrées, sorties et limites sont-elles explicites ?
• Les droits demandés sont-ils proportionnés au besoin ?
• Un ou deux exemples réels permettent-ils de comprendre l'usage ?
• Le README, le packaging et les tests minimaux sont-ils prévus ?

Cas du site

• Agent doc technique : partir de DEPLOIEMENT.md, de test-configuration.html et des pages de tutoriels pour produire une fiche plus exploitable.
• Agent QA flux : relier get-fiches-list.php, save-fiche.php et fiches.json pour construire une campagne de vérification.
• Agent sécurité : cadrer une revue autour de config.php, des fichiers de suppression et des points d'entrée PHP.
• Skill scripts : documenter une méthode de reprise autour de start-admin.ps1 et backup-data.ps1.

Ce qu'il faut éviter

• Empiler trop de règles dans les instructions globales au point de les rendre illisibles.
• Confondre un agent, une skill et un prompt file alors que ces briques n'ont pas le même rôle.
• Donner des droits larges à un agent sans formuler le périmètre et les validations.
• Partager une skill sans exemples, sans limites et sans vérification sur des cas réels.
• Emballer trop tôt sans avoir corrigé les ambiguïtés de vocabulaire et de sorties attendues.

Version débutant vers intermédiaire

• Débutant : commencer par un seul fichier d'instructions de projet et deux ou trois prompt files utiles.
• Intermédiaire : séparer les cas documentation, tests, sécurité et refactor en agents ou skills distincts.
• Plus avancé : ajouter ressources, scripts de vérification, conventions de packaging et revue collective.

Pages voisines utiles

Voir Copilot et VS Code avancé, les workflows et outils, l'ingénierie de prompt avancée, les prompts documentation, les prompts développement, les checklists et les squelettes de prompts.