Vue d'ensemble des Issues

Les Issues sont le système de CodeCourier pour repérer, suivre et résoudre les problèmes de votre codebase. Qu’elle soit identifiée par une session de scan pilotée par l’IA ou créée manuellement, chaque issue représente une unité de travail distincte - un bug à corriger, une amélioration à apporter ou une tâche à accomplir. Les issues peuvent être exécutées individuellement via des workflow runs ou regroupées en work chains pour une résolution séquentielle.

Que sont les Issues ?

Une issue est un enregistrement structuré qui capture un problème ou une tâche, avec suffisamment de contexte pour qu’un agent IA puisse la résoudre. Chaque issue comprend un titre, une description, un niveau de priorité et un suggestedPrompt optionnel qui fournit des instructions spécifiques à un agent IA. Les issues peuvent provenir de deux sources :

• Découverte par IA- Une issue session scanne votre codebase à l’aide d’un agent IA dans une sandbox cloud et extrait automatiquement une liste d’issues.
• Création manuelle- Vous créez des issues directement via l’interface, en spécifiant le titre, la description, la priorité et des instructions de correction optionnelles.

Cycle de vie d’une issue

Chaque issue traverse un cycle de vie simple et linéaire, suivi en temps réel :

Relation avec les autres concepts

Les issues se situent à l’intersection de plusieurs systèmes de CodeCourier :

• Runs- Lorsque vous exécutez une issue, un workflow run est créé et lié à celle-ci. Le run effectue le travail réel (modifications de code, création de PR) au sein d’une sandbox E2B.
• Workflows- Vous sélectionnez le blueprint de workflow à utiliser lors de l’exécution d’une issue. Le workflow définit le pipeline d’agents multi-étapes (par exemple, Designer → Checker).
• Personas- Les personas configurées dans le workflow déterminent le comportement de l’agent IA et le system prompt lors de la résolution de l’issue.
• Work Chains - Plusieurs issues peuvent être regroupées en une work chain pour une exécution par lot séquentielle, semblable à un pipeline CI de corrections.
• Issue Sessions- Des sessions de scan pilotées par l’IA qui analysent votre codebase et produisent automatiquement une liste d’issues.
• Answering Sessions- Une fois une Issue Session terminée, une Answering Session résout les questions et hypothèses générées pendant le scan, en les affinant en un contexte exploitable avant le début de l’implémentation.

Le flux de découverte et de résolution des Issues

Le cycle de vie complet, de la découverte à la résolution, suit ce schéma :

1. Issue Session- Un agent IA Planner scanne votre codebase et génère une liste structurée d’issues, ainsi que des questions et hypothèses sur les exigences, le périmètre et l’architecture.
2. Answering Session- Un Answering Agent examine les questions et hypothèses générées, les affine et produit des réponses approuvées qui servent de contexte pour l’implémentation. Vous examinez chaque hypothèse et l’approuvez, la refusez ou la corrigez.
3. Résolution de l’issue - Les issues individuelles sont exécutées via des pipelines de workflow, en utilisant les hypothèses approuvées comme contexte supplémentaire. Les issues peuvent aussi être regroupées en une work chain pour une exécution automatisée séquentielle.

Quand utiliser les Issues plutôt que les Workflows

Fonctionnalités clés

• Découverte pilotée par l’IA- Les issue sessions utilisent une sandbox cloud pour scanner l’ensemble de votre codebase et faire apparaître bugs, vulnérabilités de sécurité, problèmes de performance et opportunités d’amélioration.
• Answering Sessions- Un flux de questions- réponses structuré et piloté par l’IA qui résout les questions et valide les hypothèses issues des sessions de scan avant le début de toute implémentation, garantissant que l’IA dispose du bon contexte pour produire des corrections précises.
• Organisation par priorité- Chaque issue possède un niveau de priorité (low, medium, high, critical) afin que vous puissiez vous concentrer sur l’essentiel.
• Prompts suggérés - Chaque issue peut porter un suggestedPromptgénéré par IA avec des instructions de correction spécifiques, transmis directement au workflow run lors de l’exécution de l’issue.
• Exécution par Work Chain- Regroupez des issues et exécutez-les séquentiellement, chaque issue étant résolue dans l’ordre avant que la suivante ne commence.
• Création automatique de PR- Lorsqu’un run d’issue se termine, une pull request est créée sur le repository GitHub configuré.
• Suivi en temps réel- Les statuts des issues sont mis à jour en temps réel via des requêtes réactives, afin que vous voyiez toujours l’état actuel de chaque issue.
• Suivi de la progression de session - Les issue sessions suivent la progression via les compteurs currentIteration et maxIterations, vous donnant une visibilité sur l’avancement de l’agent dans le processus de scan.

Champs de données d’une issue

Prochaines étapes