Linear

Aperçu

Cette compétence fournit un flux de travail structuré pour gérer les problèmes, les projets et les flux de travail d'équipe dans Linear. Elle assure une intégration cohérente avec le serveur Linear MCP, qui offre la gestion de projet en langage naturel pour les problèmes, les projets, la documentation et la collaboration d'équipe.

Prérequis

• Le serveur Linear MCP doit être connecté et accessible via OAuth
• Confirmez l'accès à l'espace de travail Linear pertinent, aux équipes et aux projets

Flux de travail obligatoire

Suivez ces étapes dans l'ordre. Ne sautez pas d'étapes.

Étape 0 : Configurer Linear MCP (si non déjà configuré)

Si un appel MCP échoue parce que Linear MCP n'est pas connecté, arrêtez-vous et configurez-le :

1. Ajoutez Linear MCP :
   • codex mcp add linear --url https://mcp.linear.app/mcp
2. Activez le client MCP distant :
   • Définissez [features] rmcp_client = true dans config.toml ou exécutez codex --enable rmcp_client
3. Connectez-vous avec OAuth :
   • codex mcp login linear

Après une connexion réussie, l'utilisateur devra redémarrer codex. Vous devriez terminer votre réponse et lui dire que lorsqu'il réessaie, il peut continuer avec l'Étape 1.

Remarque Windows/WSL : Si vous voyez des erreurs de connexion sur Windows, essayez de configurer Linear MCP pour s'exécuter via WSL :

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}

Étape 1

Clarifiez l'objectif et l'étendue de l'utilisateur (par exemple, triage des problèmes, planification de sprint, audit de documentation, équilibre de charge de travail). Confirmez l'équipe/projet, la priorité, les étiquettes, le cycle et les dates d'échéance selon les besoins.

Étape 2

Sélectionnez le flux de travail approprié (voir Flux de travail pratiques ci-dessous) et identifiez les outils Linear MCP dont vous aurez besoin. Confirmez les identifiants requis (ID du problème, ID du projet, clé d'équipe) avant d'appeler les outils.

Étape 3

Exécutez les appels d'outils Linear MCP par lots logiques :

• Lisez d'abord (list/get/search) pour construire le contexte.
• Créez ou mettez à jour ensuite (problèmes, projets, étiquettes, commentaires) avec tous les champs requis.
• Pour les opérations en masse, expliquez la logique de regroupement avant d'appliquer les modifications.

Étape 4

Résumez les résultats, signalez les lacunes ou blocages restants et proposez les prochaines étapes (problèmes supplémentaires, modifications d'étiquettes, assignations ou commentaires de suivi).

Outils disponibles

Gestion des problèmes : list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Projet & Équipe : list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Documentation & Collaboration : list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Flux de travail pratiques

• Sprint Planning : Passez en revue les problèmes ouverts pour une équipe cible, choisissez les meilleurs éléments par priorité et créez un nouveau cycle (par exemple, "Q1 Performance Sprint") avec des assignations.
• Bug Triage : Listez les bogues critiques/haute priorité, classez-les par impact utilisateur et déplacez les meilleurs éléments vers "In Progress".
• Documentation Audit : Recherchez la documentation (par exemple, auth API), puis ouvrez les problèmes étiquetés "documentation" pour les lacunes ou les sections obsolètes avec des corrections détaillées.
• Team Workload Balance : Groupez les problèmes actifs par assignataire, signalez toute personne ayant une charge élevée et suggérez ou appliquez des redistributions.
• Release Planning : Créez un projet (par exemple, "v2.0 Release") avec des jalons (gel des fonctionnalités, bêta, docs, lancement) et générez des problèmes avec des estimations.
• Cross-Project Dependencies : Trouvez tous les problèmes "bloqués", identifiez les bloquants et créez des problèmes liés si manquants.
• Automated Status Updates : Trouvez vos problèmes avec des mises à jour obsolètes et ajoutez des commentaires de statut en fonction de l'état actuel/des bloquants.
• Smart Labeling : Analysez les problèmes non étiquetés, suggérez/appliquez les étiquettes et créez les catégories d'étiquettes manquantes.
• Sprint Retrospectives : Générez un rapport pour le dernier cycle complété, notez le travail complété par rapport au travail repoussé et ouvrez les problèmes de discussion pour les motifs.

Conseils pour une productivité maximale

• Groupez les opérations pour les modifications connexes ; envisagez les modèles intelligents pour les structures de problèmes récurrentes.
• Utilisez les requêtes en langage naturel si possible ("Montrez-moi sur quoi John travaille cette semaine").
• Exploitez le contexte : référencez les problèmes antérieurs dans les nouvelles demandes.
• Divisez les mises à jour volumineuses en lots plus petits pour éviter les limites de débit ; mettez en cache ou réutilisez les filtres lors de listes fréquentes.

Dépannage

• Authentification : Effacez les cookies du navigateur, réexécutez OAuth, vérifiez les permissions de l'espace de travail, assurez-vous que l'accès API est activé.
• Erreurs d'appel d'outils : Confirmez que le modèle prend en charge les appels d'outils multiples, fournissez tous les champs requis et divisez les demandes complexes.
• Données manquantes : Actualisez le jeton, vérifiez l'accès à l'espace de travail, vérifiez les projets archivés et confirmez la sélection correcte de l'équipe.
• Performance : Souvenez-vous des limites de débit de l'API Linear ; groupez les opérations en masse, utilisez les filtres spécifiques ou mettez en cache les requêtes fréquentes.