Topics
Organisez les tâches liées en topics et donnez-leur un objectif, un plan et un contexte d'exécution communs.
Les topics 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 topic. Les topics 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 topic
| Élément | Rôle |
|---|---|
| Nom, icône et description | Objectif, périmètre et exigences durables ; la description entre dans le contexte d'exécution des agents qui travaillent dans le topic. |
| Statut | planned (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é). |
| Responsable | Un membre ou un agent — la personne ou l'agent qui coordonne le topic. |
| Dates de début et d'échéance | La période prévue du topic. |
| Tâches et avancement | Le travail du topic et la part déjà terminée. |
| Ressources | Dépôts GitHub rattachés ou répertoires locaux sur des ordinateurs précis. |
Topics et tâches
Un topic peut contenir un nombre quelconque de tâches ; une tâche appartient à un topic au plus. Créez des tâches directement dans le topic, ou choisissez ou changez le topic depuis les propriétés de la tâche.
L'avancement du topic est calculé automatiquement à partir des tâches liées :
avancement = tâches en done ou cancelled ÷ toutes les tâches du topiccancelled signifie que ce travail a été retiré du périmètre du topic ; il compte donc dans l'avancement. Le statut du topic et celui des tâches sont indépendants : terminer toutes les tâches ne fait pas passer automatiquement le topic à completed, et modifier le statut du topic ne modifie pas ses tâches en masse.
Description du topic et contexte d'exécution
Lorsqu'un agent traite une tâche d'un topic, le nom et la description du topic sont ajoutés au contexte de cette exécution. La description est l'endroit où placer les informations dont toutes les tâches liées ont besoin : l'objectif, les limites techniques, les conventions de livraison. Les exigences propres à une seule tâche ont leur place dans cette tâche.
Ajouter des ressources
Les ressources du topic 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 topic pour savoir comment choisir et connaître les limites de sécurité.
Responsable du topic
Le responsable peut être un membre ou un agent, et indique qui coordonne le topic. Ce n'est pas un paramètre de permission : il n'assigne pas automatiquement les tâches du topic, et désigner un agent comme responsable ne le lance pas automatiquement. Démarrer une exécution nécessite toujours l'assignation d'une tâche, une @mention ou un déclencheur d'automatisation.
Épingler à la barre latérale
Un topic é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 topics ; seuls les rôles owner et admin peuvent les supprimer.
Supprimer un topic 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 topic sont définitivement supprimés.
Étapes suivantes
- Ressources de topic — rattachez des dépôts GitHub ou des répertoires locaux.
- Tâches — créez et organisez le travail concret d'un topic.
- Agents — découvrez l'identité, la configuration et l'Accès des agents.