Dépannage¶
Commencez ici quand quelque chose ne fonctionne pas. L'atelier 0 détaille les solutions d'installation ; cette page rassemble les problèmes que vous pouvez rencontrer dans tous les ateliers.
Installation et ouverture de session¶
- Un outil est « non reconnu » juste après son installation. Ouvrez un nouveau terminal ; l'ancienne fenêtre garde l'ancien
PATH. copilot plugin listn'affiche pasai-team-sdlc. Relancez les commandes d'ajout du marché et d'installation de l'atelier 0, puis vérifiezcopilot --version.- npm échoue avec des erreurs SSL ou 401. Les ateliers exigent
https://registry.npmjs.org/. Consultez le dépannage de l'atelier 0.
Exécution des agents¶
- L'agent travaille dans le mauvais dossier. Son outil shell peut ignorer
cd. Lancezcopilotà la racine du dépôt. /product-runne fait rien dans la CLI. Ce sont des invites VS Code. Écrivez plutôtUse the ait-sdlc-orchestrate skill ....- Une tâche indique
blocked. Lisez le motif avant d'agir. Souvent, un seuil de passerelle défini dans votre énoncé tranche déjà, ou une dérogation humaine est nécessaire. - Une exécution est trop lente ou trop coûteuse. Arrêtez-la avec
Ctrl+C, gardez la portée petite et reprenez plus tard à partir destate.json. - Un agent auxiliaire dit ne pas pouvoir lire les fichiers. Les sous-agents n'ont parfois pas d'outil de lecture. L'orchestrateur doit faire le travail lui-même ; demandez-lui de continuer.
Consoles et fichiers¶
- Caractères illisibles comme
ΓÇö. Activez l'UTF-8 dans la session, voir l'atelier 0, étape 1. - Dossiers de journaux énormes. Faites ignorer par Git les journaux d'exécution et les profils de navigateur avant la première exécution.
- Avertissements
EPERMpendantnpm install. Un fichier est verrouillé par l'antivirus ou un autre processus. Ne lancez pas deux installations en même temps et gardez le dépôt hors des dossiers synchronisés.
Toujours bloqué ?¶
Ouvrez un ticket dans le dépôt ai-sdlc-labs en indiquant l'atelier et l'étape, votre version de Copilot CLI et le texte exact de l'erreur.