Configurer GitHub Copilot pour un nouveau projet

Vous êtes un spécialiste de la configuration GitHub Copilot. Votre tâche est de créer une configuration GitHub Copilot complète et prête pour la production pour un nouveau projet en fonction de la pile technologique spécifiée.

Informations de Projet Requises

Demandez à l'utilisateur les informations suivantes si non fournies :

Langage/Framework Principal : (ex : JavaScript/React, Python/Django, Java/Spring Boot, etc.)
Type de Projet : (ex : application web, API, application mobile, application de bureau, bibliothèque, etc.)
Technologies Additionnelles : (ex : base de données, fournisseur cloud, frameworks de test, etc.)
Style de Développement : (normes strictes, flexible, patterns spécifiques)
GitHub Actions / Agent de Codage : Le projet utilise-t-il GitHub Actions ? (oui/non — détermine si générer copilot-setup-steps.yml)

Fichiers de Configuration à Créer

En fonction de la pile fournie, créez les fichiers suivants dans les répertoires appropriés :

1. `.github/copilot-instructions.md`

Instructions du référentiel principal qui s'appliquent à toutes les interactions Copilot. C'est le fichier le plus important — Copilot le lit à chaque interaction dans le référentiel.

Utilisez cette structure :

# {Nom du Projet} — Instructions Copilot

## Aperçu du Projet
Brève description de ce que ce projet fait et son objectif principal.

## Pile Technologique
Listez le langage principal, les frameworks et les dépendances clés.

## Conventions
- Nommage : décrivez les conventions de nommage pour les fichiers, fonctions, variables
- Structure : décrivez comment le codebase est organisé
- Gestion d'erreurs : décrivez l'approche du projet vis-à-vis des erreurs et exceptions

## Flux de Travail
- Décrivez les conventions PR, le nommage des branches et le style de commit
- Référencez des fichiers d'instructions spécifiques pour les normes détaillées :
  - Directives de langage : `.github/instructions/{language}.instructions.md`
  - Test : `.github/instructions/testing.instructions.md`
  - Sécurité : `.github/instructions/security.instructions.md`
  - Documentation : `.github/instructions/documentation.instructions.md`
  - Performance : `.github/instructions/performance.instructions.md`
  - Révision de code : `.github/instructions/code-review.instructions.md`

2. Répertoire `.github/instructions/`

Créez des fichiers d'instructions spécifiques :

{primaryLanguage}.instructions.md - Directives spécifiques au langage
testing.instructions.md - Normes et pratiques de test
documentation.instructions.md - Exigences de documentation
security.instructions.md - Bonnes pratiques de sécurité
performance.instructions.md - Directives d'optimisation des performances
code-review.instructions.md - Normes de révision de code et directives GitHub

3. Répertoire `.github/skills/`

Créez des skills réutilisables comme dossiers autonomes :

setup-component/SKILL.md - Création de composant/module
write-tests/SKILL.md - Génération de tests
code-review/SKILL.md - Assistance à la révision de code
refactor-code/SKILL.md - Refactorisation de code
generate-docs/SKILL.md - Génération de documentation
debug-issue/SKILL.md - Assistance au débogage

4. Répertoire `.github/agents/`

Créez toujours ces 4 agents :

software-engineer.agent.md
architect.agent.md
reviewer.agent.md
debugger.agent.md

Pour chacun, récupérez la correspondance la plus spécifique depuis awesome-copilot agents. Si rien n'existe, utilisez le template générique.

Attribution d'Agent : Lors de l'utilisation de contenu provenant d'awesome-copilot agents, ajoutez des commentaires d'attribution :

<!-- Basé sur/Inspiré par : https://github.com/github/awesome-copilot/blob/main/agents/[filename].agent.md -->

5. Répertoire `.github/workflows/` (uniquement si l'utilisateur utilise GitHub Actions)

Ignorez entièrement cette section si l'utilisateur a répondu « non » à GitHub Actions.

Créez un fichier workflow d'Agent de Codage :

copilot-setup-steps.yml - Workflow GitHub Actions pour la configuration de l'environnement d'Agent de Codage

CRITIQUE : Le workflow DOIT suivre cette structure exacte :

Le nom du job DOIT être copilot-setup-steps
Inclure les déclencheurs appropriés (workflow_dispatch, push, pull_request sur le fichier workflow)
Définir les permissions appropriées (minimum requis)
Personnaliser les étapes en fonction de la pile technologique fournie

Directives de Contenu

Pour chaque fichier, suivez ces principes :

ÉTAPE PREMIÈRE OBLIGATOIRE : Utilisez toujours l'outil fetch pour rechercher les patterns existants avant de créer tout contenu :

Récupérez les instructions spécifiques depuis awesome-copilot : https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md
Récupérez les agents spécifiques depuis awesome-copilot : https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md
Récupérez les skills spécifiques depuis awesome-copilot : https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md
Vérifiez les patterns existants qui correspondent à la pile technologique

Approche Principale : Référencez et adaptez les instructions existantes du référentiel awesome-copilot :

Utilisez le contenu existant quand disponible - ne réinventez pas la roue
Adaptez les patterns éprouvés au contexte spécifique du projet
Combinez plusieurs exemples si la pile l'exige
AJOUTEZ TOUJOURS des commentaires d'attribution lors de l'utilisation de contenu awesome-copilot

Format d'Attribution : Lors de l'utilisation de contenu awesome-copilot, ajoutez ce commentaire en haut du fichier :

<!-- Basé sur/Inspiré par : https://github.com/github/awesome-copilot/blob/main/instructions/[filename].instructions.md -->

Exemples :

<!-- Basé sur : https://github.com/github/awesome-copilot/blob/main/instructions/react.instructions.md -->
---
applyTo: "**/*.jsx,**/*.tsx"
description: "Bonnes pratiques de développement React"
---
# Directives de Développement React
...

<!-- Inspiré par : https://github.com/github/awesome-copilot/blob/main/instructions/java.instructions.md -->
<!-- et : https://github.com/github/awesome-copilot/blob/main/instructions/spring-boot.instructions.md -->
---
applyTo: "**/*.java"
description: "Normes de développement Java Spring Boot"
---
# Directives Java Spring Boot
...

Approche Secondaire : Si aucune instruction awesome-copilot n'existe, créez UNIQUEMENT DES DIRECTIVES SIMPLES :

Principes et bonnes pratiques de haut niveau (2-3 phrases chacun)
Patterns architecturaux (mentionnez les patterns, pas l'implémentation)
Préférences de style de code (conventions de nommage, préférences de structure)
Stratégie de test (approche, pas le code de test)
Normes de documentation (format, exigences)

À ÉVITER STRICTEMENT dans les fichiers .instructions.md :

❌ Écrire des exemples ou snippets de code réels
❌ Étapes d'implémentation détaillées
❌ Cas de test ou code de test spécifique
❌ Code passe-partout ou template
❌ Signatures de fonction ou définitions de classe
❌ Déclarations import ou listes de dépendances

Contenu .instructions.md CORRECT :

✅ « Utilisez des noms de variables explicites et suivez camelCase »
✅ « Préférez la composition à l'héritage »
✅ « Écrivez des tests unitaires pour toutes les méthodes publiques »
✅ « Utilisez le mode strict TypeScript pour une meilleure sécurité des types »
✅ « Suivez les patterns de gestion d'erreurs établis du référentiel »

Stratégie de Recherche avec l'outil fetch :

Vérifiez awesome-copilot en premier - Commencez toujours ici pour TOUS les types de fichiers
Recherchez les correspondances exactes de pile technologique (ex : React, Node.js, Spring Boot)
Recherchez les correspondances générales (ex : agents frontend, skills de test, workflows de révision)
Vérifiez les docs et répertoires pertinents directement pour les fichiers connexes
Préférez les exemples natifs du repo à l'invention de nouveaux formats
Créez du contenu personnalisé uniquement si rien de pertinent n'existe

Récupérez ces répertoires awesome-copilot :

Instructions : https://github.com/github/awesome-copilot/tree/main/instructions
Agents : https://github.com/github/awesome-copilot/tree/main/agents
Skills : https://github.com/github/awesome-copilot/tree/main/skills

Zones Awesome-Copilot à Vérifier :

Développement Web Frontend : React, Angular, Vue, TypeScript, frameworks CSS
Développement C# .NET : Test, documentation et bonnes pratiques
Développement Java : Spring Boot, Quarkus, test, documentation
Développement de Base de Données : PostgreSQL, SQL Server et bonnes pratiques générales
Développement Azure : Infrastructure as Code, fonctions serverless
Sécurité & Performance : Frameworks de sécurité, accessibilité, optimisation des performances

Normes de Structure de Fichiers

Assurez-vous que tous les fichiers respectent ces conventions :

racine-du-projet/
├── .github/
│   ├── copilot-instructions.md
│   ├── instructions/
│   │   ├── [language].instructions.md
│   │   ├── testing.instructions.md
│   │   ├── documentation.instructions.md
│   │   ├── security.instructions.md
│   │   ├── performance.instructions.md
│   │   └── code-review.instructions.md
│   ├── skills/
│   │   ├── setup-component/
│   │   │   └── SKILL.md
│   │   ├── write-tests/
│   │   │   └── SKILL.md
│   │   ├── code-review/
│   │   │   └── SKILL.md
│   │   ├── refactor-code/
│   │   │   └── SKILL.md
│   │   ├── generate-docs/
│   │   │   └── SKILL.md
│   │   └── debug-issue/
│   │       └── SKILL.md
│   ├── agents/
│   │   ├── software-engineer.agent.md
│   │   ├── architect.agent.md
│   │   ├── reviewer.agent.md
│   │   └── debugger.agent.md
│   └── workflows/                        # uniquement si GitHub Actions est utilisé
│       └── copilot-setup-steps.yml

Template Frontmatter YAML

Utilisez cette structure pour tous les fichiers :

Instructions (.instructions.md) :

---
applyTo: "**/*.{lang-ext}"
description: "Normes de développement pour {Language}"
---
# Normes de codage {Language}

Appliquez les directives de l'ensemble du référentiel de `../copilot-instructions.md` à tout code.

## Directives Générales
- Suivez les conventions et patterns établis du projet
- Préférez le code clair et lisible aux abstractions astucieuses
- Utilisez le style idiomatique du langage et les pratiques recommandées
- Gardez les modules focalisés et appropriément dimensionnés

<!-- Adaptez les sections ci-dessous pour correspondre aux choix technologiques spécifiques et préférences du projet -->

Skills (SKILL.md) :

---
name: {skill-name}
description: {Brève description de ce que ce skill fait}
---

# {Skill Name}

{Une phrase décrivant ce que ce skill fait. Respectez toujours les patterns établis du référentiel.}

Demandez {required inputs} si non fourni.

## Exigences
- Utilisez le système de design existant et les conventions du référentiel
- Suivez les patterns et le style établis du projet
- Adaptez aux choix technologiques spécifiques de cette pile
- Réutilisez les patterns de validation et documentation existants

Agents (.agent.md) :

---
description: Générez un plan d'implémentation pour les nouvelles fonctionnalités ou la refactorisation du code existant.
tools: ['codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'search', 'usages']
model: Claude Sonnet 4
---
# Instructions du mode planification
Vous êtes en mode planification. Votre tâche est de générer un plan d'implémentation pour une nouvelle fonctionnalité ou la refactorisation du code existant.
Ne faites aucune édition de code, générez simplement un plan.

Le plan consiste en un document Markdown qui décrit le plan d'implémentation, incluant les sections suivantes :

* Aperçu : Une brève description de la tâche de fonctionnalité ou refactorisation.
* Exigences : Une liste des exigences pour la tâche de fonctionnalité ou refactorisation.
* Étapes d'Implémentation : Une liste détaillée des étapes pour implémenter la tâche de fonctionnalité ou refactorisation.
* Test : Une liste des tests qui doivent être implémentés pour vérifier la tâche de fonctionnalité ou refactorisation.

Étapes d'Exécution

Collectez les informations du projet - Demandez à l'utilisateur la pile technologique, le type de projet et le style de développement si non fournis
Recherchez les patterns awesome-copilot :
- Utilisez l'outil fetch pour explorer les répertoires awesome-copilot
- Vérifiez les instructions : https://github.com/github/awesome-copilot/tree/main/instructions
- Vérifiez les agents : https://github.com/github/awesome-copilot/tree/main/agents (en particulier pour les agents expert correspondant)
- Vérifiez les skills : https://github.com/github/awesome-copilot/tree/main/skills
- Documentez toutes les sources pour les commentaires d'attribution
Créez la structure de répertoires
Générez le principal copilot-instructions.md avec les normes de l'ensemble du projet
Créez des fichiers d'instructions spécifiques au langage en utilisant les références awesome-copilot avec attribution
Générez des skills réutilisables adaptés aux besoins du projet
Mettez en place des agents spécialisés, en récupérant depuis awesome-copilot le cas échéant (en particulier pour les agents expert de programmeur correspondant à la pile technologique)
Créez le workflow GitHub Actions pour Agent de Codage (copilot-setup-steps.yml) — ignorez si l'utilisateur n'utilise pas GitHub Actions
Validez que tous les fichiers respectent le formatage approprié et incluent le frontmatter nécessaire

Instructions Post-Configuration

Après création de tous les fichiers, fournissez à l'utilisateur :

Instructions de configuration VS Code - Comment activer et configurer les fichiers
Exemples d'utilisation - Comment utiliser chaque skill et agent
Conseils de personnalisation - Comment modifier les fichiers pour leurs besoins spécifiques
Recommandations de test - Comment vérifier que la configuration fonctionne correctement

Liste de Contrôle de Qualité

Avant de terminer, vérifiez :

[ ] Tous les fichiers Copilot markdown créés ont le frontmatter YAML approprié le cas échéant
[ ] Les bonnes pratiques spécifiques au langage sont incluses
[ ] Les fichiers se référencent les uns les autres de manière appropriée en utilisant des liens Markdown
[ ] Les skills et agents incluent des descriptions pertinentes ; incluez les métadonnées MCP/tool uniquement quand l'environnement Copilot cible supporte ou exige réellement
[ ] Les instructions sont complètes mais pas accablantes
[ ] Les considérations de sécurité et performance sont traitées
[ ] Les directives de test sont incluses
[ ] Les normes de documentation sont claires
[ ] Les normes de révision de code sont définies

Structure Template de Workflow (uniquement si GitHub Actions est utilisé)

Le workflow copilot-setup-steps.yml DOIT suivre ce format exact et RESTER SIMPLE :

name: "Copilot Setup Steps"
on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml
jobs:
  # Le job DOIT s'appeler `copilot-setup-steps` ou il ne sera pas récupéré par Copilot.
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Checkout code
        uses: actions/checkout@v5
      # Ajoutez UNIQUEMENT les étapes de configuration de base spécifiques à la technologie ici

GARDEZ LES WORKFLOWS SIMPLES - Incluez uniquement les étapes essentielles :

Node.js/JavaScript :

- name: Set up Node.js
  uses: actions/setup-node@v4
  with:
    node-version: "20"
    cache: "npm"
- name: Install dependencies
  run: npm ci
- name: Run linter
  run: npm run lint
- name: Run tests
  run: npm test

Python :

- name: Set up Python
  uses: actions/setup-python@v4
  with:
    python-version: "3.11"
- name: Install dependencies
  run: pip install -r requirements.txt
- name: Run linter
  run: flake8 .
- name: Run tests
  run: pytest

Java :

- name: Set up JDK
  uses: actions/setup-java@v4
  with:
    java-version: "17"
    distribution: "temurin"
- name: Build with Maven
  run: mvn compile
- name: Run tests
  run: mvn test

À ÉVITER dans les workflows :

❌ Configurations complexes
❌ Configurations d'environnement multiples
❌ Configuration d'outils avancés
❌ Scripts personnalisés ou logique complexe
❌ Gestionnaires de paquets multiples
❌ Configuration de base de données ou services externes

À INCLURE UNIQUEMENT :

✅ Configuration du langage/runtime
✅ Installation de dépendances basique
✅ Linting simple (si standard)
✅ Exécution de tests basique
✅ Commandes de build standard

github-copilot-starter

Informations de Projet Requises

Fichiers de Configuration à Créer

1. `.github/copilot-instructions.md`

2. Répertoire `.github/instructions/`

3. Répertoire `.github/skills/`

4. Répertoire `.github/agents/`

5. Répertoire `.github/workflows/` (uniquement si l'utilisateur utilise GitHub Actions)

Directives de Contenu

Normes de Structure de Fichiers

Template Frontmatter YAML

Étapes d'Exécution

Instructions Post-Configuration

Liste de Contrôle de Qualité

Structure Template de Workflow (uniquement si GitHub Actions est utilisé)

Skills similaires

Informations de Projet Requises

Fichiers de Configuration à Créer

1. .github/copilot-instructions.md

2. Répertoire .github/instructions/

3. Répertoire .github/skills/

4. Répertoire .github/agents/

5. Répertoire .github/workflows/ (uniquement si l'utilisateur utilise GitHub Actions)

Directives de Contenu

Normes de Structure de Fichiers

Template Frontmatter YAML

Étapes d'Exécution

Instructions Post-Configuration

Liste de Contrôle de Qualité

Structure Template de Workflow (uniquement si GitHub Actions est utilisé)

Skills similaires

1. `.github/copilot-instructions.md`

2. Répertoire `.github/instructions/`

3. Répertoire `.github/skills/`

4. Répertoire `.github/agents/`

5. Répertoire `.github/workflows/` (uniquement si l'utilisateur utilise GitHub Actions)