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.
Un cadre global pour tout le workspace : langue, niveau de détail, validations attendues, conventions et interdits récurrents.
Une bibliothèque de demandes versionnées pour des cas répétitifs : plan de tests, revue sécurité, doc technique, migration ou refactor.
Un rôle spécialisé avec instructions, périmètre et parfois un tools set adapté : doc, QA, sécurité, refactor ou support.
Une compétence emballée avec consignes, ressources et parfois scripts ou exemples, utile pour transmettre une méthode récurrente.
Un skill ou un agent gagne en robustesse quand on documente clairement son but, ses entrées, ses limites, ses dépendances et ses sorties.
Tester, versionner, relire et empaqueter proprement fait la différence entre une bonne idée locale et un outillage transmissible.
# .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.
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.
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.
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
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.
But : transformer notes, pages et scripts en fiche claire. Sorties : plan, synthèse, guide court, zones à compléter.
But : produire cas limites, non-régression et validations de flux. Sorties : plan de tests, jeux de données, checklist.
But : relire les points d'entrée et les configurations sensibles. Sorties : risques, priorisation, validations manuelles, correctifs prudents.
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.
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.