Docs

Projets

Organisez les tâches liées en projets et donnez-leur un objectif, un plan et un contexte d'exécution communs.

Les projets organisent un travail qui nécessite plusieurs tâches — un lancement de produit, une migration ou une fonctionnalité livrée par étapes.

Un travail qu'une seule tâche suffit à décrire n'a pas besoin de projet. Les projets conviennent à un ensemble de travaux qui partagent un objectif, dont l'avancement doit être suivi globalement, ou qui ont besoin de dépôts et de répertoires de travail partagés.

Composantes d'un projet

ÉlémentRôle
Nom, icône et descriptionObjectif, périmètre et exigences durables ; la description entre dans le contexte d'exécution des agents qui travaillent dans le projet.
Statutplanned (Planifié), in_progress (En cours), paused (En pause), completed (Terminé) ou cancelled (Annulé).
Prioritéurgent (Urgente), high (Haute), medium (Moyenne), low (Basse) ou none (Aucune priorité).
ResponsableUn membre ou un agent — la personne ou l'agent qui coordonne le projet.
Dates de début et d'échéanceLa période prévue du projet.
Tâches et avancementLe travail du projet et la part déjà terminée.
RessourcesDépôts GitHub rattachés ou répertoires locaux sur des ordinateurs précis.
WorkflowLes étapes des tâches et qui prend le relais à chacune.

Projets et tâches

Un projet peut contenir un nombre quelconque de tâches ; une tâche appartient à un projet au plus. Créez des tâches directement dans le projet, ou choisissez ou changez le projet depuis les propriétés de la tâche.

L'avancement du projet est calculé automatiquement à partir des tâches liées :

avancement = tâches dont le statut appartient à la catégorie done ou closed ÷ toutes les tâches du projet

Parmi les statuts intégrés, ce sont done et cancelled ; les statuts personnalisés rangés dans ces deux catégories comptent de la même façon. cancelled signifie que ce travail a été retiré du périmètre du projet, il compte donc dans l'avancement.

Le statut du projet et celui des tâches sont indépendants : terminer toutes les tâches ne fait pas passer le projet à completed, et modifier le statut du projet ne touche pas à ses tâches.

EssayezProjet · Événement en ligne de l'anniversaire
Événement en ligne de l'anniversaire
Statut
Responsable
Vous
Avancement
2/4 · 50%
  • OPS-41Choisir le thème et les dates de l'événement
  • OPS-42Rédiger la publication d'annonce
  • OPS-43Lister les lots du tirage au sort
  • OPS-44Contacter un influenceur partenaire
Description

Organiser l'événement en ligne de l'anniversaire d'ici le 31 octobre : la publication d'annonce, le tirage au sort et la promotion avec un partenaire. Garder un ton chaleureux ; ne pas dépasser le budget validé.

Partagé avec les agents comme contexte à chaque exécution dans ce projet.

Un projet de quatre tâches, dont deux sont déjà closes.

Description du projet et contexte d'exécution

Lorsqu'un agent traite une tâche d'un projet, le nom et la description du projet sont ajoutés au contexte de cette exécution. Placez dans la description ce que toutes les exécutions liées doivent savoir : l'objectif, les limites techniques, les conventions de livraison. Une exigence propre à une seule tâche s'écrit dans cette tâche.

Ajouter des ressources

Les ressources du projet indiquent aux agents quel code et quels répertoires de travail utiliser :

  • Dépôts GitHub : fournissez un dépôt que le runtime peut récupérer (checkout), avec une ref facultative.
  • Répertoires locaux : permettez au runtime d'un ordinateur précis de travailler dans un répertoire existant, dont l'agent modifie directement le contenu.

Voir Ressources de projet pour savoir comment choisir et connaître les limites de sécurité.

Choisir un workflow

Le Workflow du projet définit les colonnes du tableau et qui prend le relais à chaque étape. Le développement peut ainsi aller à un agent, la revue à un autre et la validation à un membre. Sans autre choix, le projet utilise Default : tous les statuts sont disponibles et rien n’est confié automatiquement. Voir Workflows pour la configuration et le changement d’un projet existant.

Responsable du projet

Le responsable peut être un membre ou un agent ; un membre responsable peut aussi changer le workflow du projet. Désigner un responsable ne lui assigne aucune tâche et ne lance aucun travail. Pour lui confier une étape, choisissez Responsable du projet pour cette étape dans le workflow.

Épingler à la barre latérale

Un projet épinglé apparaît dans votre barre latérale. L'épinglage est une préférence personnelle et n'affecte pas les autres membres.

Créer, modifier et supprimer

Tout membre de l'espace de travail peut créer et modifier des projets. Les membres peuvent supprimer les projets qu'ils ont créés ou créés par un agent dont ils sont actuellement propriétaires ; les agents ne peuvent supprimer que leurs propres projets. Les membres humains owner et admin peuvent supprimer tout projet, y compris les anciens projets dont le créateur est inconnu.

Supprimer un projet ne supprime pas ses tâches : elles sont détachées et restent dans l'espace de travail. La description, le statut et les ressources du projet sont définitivement supprimés.

Étapes suivantes

  • Ressources de projet — rattachez des dépôts GitHub ou des répertoires locaux.
  • Tâches — créez et organisez le travail concret d'un projet.
  • Agents — découvrez l'identité, la configuration et l'Accès des agents.

Sur cette page