Tableaux Azure DevOps : mes cartes

Que fait Tableaux Azure DevOps : mes cartes ?

Aidez une personne à gérer ses propres cartes sur Azure Boards via MCP ou az. Les conventions d'équipe se trouvent dans la configuration ; la même compétence s'adapte à différentes équipes.

1. Avant tout

1. Lire la configuration — ~/.config/ado-boards/config.md (Windows : %USERPROFILE%\.config\ado-boards\config.md). Absente → exécuter d'abord la configuration de base (workflows/setup.md) ; deviner l'organisation/projet écrit au mauvais endroit. Les valeurs marquées not set yet sont collectées la première fois qu'un workflow en a besoin.
2. Choisir le backend pour ce tour uniquement :
   • MCP lorsque les outils Azure DevOps MCP sont disponibles (par ex. wit_work_item) : charger mcp-tools.md (plus un seul fichier d'écart az/ uniquement lorsque ce document décrit un écart MCP).
   • az sinon : charger az/README.md plus le fichier de section correspondant à ce workflow. Également az/windows.md uniquement lorsqu'une écriture de description/CA HTML est corrompue, ou que l'échappement PowerShell échoue. Confirmer la connexion (az account show ou AZURE_DEVOPS_EXT_PAT) ; si rien, l'utilisateur exécute az login lui-même.
   • Aucun → pointer vers la configuration.
3. Ouvrir le workflow correspondant (tableau ci-dessous) et le suivre. Les workflows disent quoi faire ; le fichier backend dit comment. Les règles de la §2 lient les deux backends.

Terminé une fois la configuration en main, un backend choisi et le fichier workflow ouvert.

L'utilisateur se connecte lui-même (Entra / az login). Les identifiants restent hors du chat.

2. Règles

Les lectures ne nécessitent aucune permission. Chaque écriture nécessite un aperçu et un oui explicite — même lorsque l'outil lui-même ne le demande pas. Le tableau est partagé ; les écritures MCP ignorent souvent une invite, donc l'aperçu est la barrière.

Règle	Critère
Taille de l'aperçu	Un changement sur la propre carte de l'utilisateur → une ligne (#512 : State Active -> Closed. OK ?). Plusieurs changements, ou la carte de quelqu'un d'autre → tableau (ID, champ, ancien, nouveau). Plus de 10 → indiquer le nombre et confirmer à nouveau.
Relecture	Après chaque écriture : rapporter l'ID, ce qui a changé, l'URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id>.
Parents	Lorsque la configuration indique Parent required: yes, créer uniquement avec un parent (les orphelins disparaissent des vues backlog).
Bogues	Lorsque la configuration indique que les bogues vivent ailleurs : proposer une Tâche sous le bogue existant (un deuxième Bogue divise l'historique).
Cartes externes	Préfixe de titre dans la configuration (par ex. EXT) : avertir que les commentaires peuvent être synchronisés avec le rapporteur avant un changement de commentaire ou de champ ; ignorer l'Impact lors de la fermeture.
Unités	Les champs de temps sont des nombres simples ; l'unité est dans la configuration. Convertir lorsque l'utilisateur mentionne une autre unité, afficher les deux, toujours nommer l'unité (l'interface Boards affiche "h" dans les deux cas).
Les cartes restent	Fermer ou déplacer ; laisser la carte sur le tableau. Supprimer un commentaire seulement après l'avoir montré en entier et obtenu un oui — aucune n'est annulable.
Propres commentaires	Modifier ou supprimer uniquement ceux de l'utilisateur (ADO rejette le reste).
Valeurs réelles	Demander des estimations, des responsables, des dates, de l'impact — ou laisser vide. Des nombres inventés semblent réels sur le tableau.
Guillemets sûrs	Citer les valeurs en toute sécurité ; les titres peuvent contenir des guillemets.
Pied de page d'écriture	Après une écriture : ce que vous avez fait, ce que vous avez ignoré, une prochaine étape. Lectures simples : répondre uniquement.

3. Workflows

Quand	Ouvrir
Configurer la compétence ado ; configuration manquante ; quelque chose a changé	workflows/setup.md
Qu'est-ce que j'ai à faire ; afficher mes cartes ; déplacer ; enregistrer du temps ; fermer	workflows/my-cards.md
Créer une carte ; découper une histoire en tâches	workflows/create-card.md
Ajouter, lister, modifier ou supprimer un commentaire	workflows/comments.md
Description ou critères d'acceptation	workflows/write-description.md
Planifier mon sprint ; sur quoi devrais-je travailler en premier	workflows/plan-my-sprint.md

4. Référence agile (vérifier dans la configuration)

Hiérarchie : Epic > Feature > User Story > Task. Les bogues se situent à côté ou sous les récits selon le paramétrage de l'équipe.

Type	États
Feature / User Story	Nouveau, Actif, Résolu, Fermé, Supprimé
Bogue	Nouveau, Actif, Résolu, Fermé
Tâche	Nouveau, Actif, Fermé, Supprimé

Parents : Tâche sous User Story (ou Bogue), User Story sous Feature. Les états personnalisés et les champs obligatoires sont stockés dans la configuration une fois collectés.