Linear

Aperçu

Cette skill fournit un workflow structuré pour gérer les issues, projets et workflows d'équipe dans Linear. Elle garantit une intégration cohérente avec le serveur Linear MCP, qui offre une gestion de projets en langage naturel pour les issues, projets, documentation et 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, aux équipes et aux projets pertinents

Workflow requis

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

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

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

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

Après une connexion réussie, l'utilisateur devra redémarrer codex. Vous devez terminer votre réponse et lui indiquer de recommencer pour continuer avec l'étape 1.

Note Windows/WSL : Si vous voyez des erreurs de connexion sur Windows, essayez de configurer le 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 la portée de l'utilisateur (par ex. triage des issues, planification de sprint, audit de documentation, équilibre de charge de travail). Confirmez l'équipe/projet, la priorité, les labels, le cycle et les dates d'échéance selon les besoins.

Étape 2

Sélectionnez le workflow approprié (voir Workflows pratiques ci-dessous) et identifiez les outils Linear MCP dont vous aurez besoin. Confirmez les identifiants requis (ID de l'issue, ID du projet, clé de l'é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 (issues, projets, labels, 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 actions (issues supplémentaires, changements de labels, affectations ou commentaires de suivi).

Outils disponibles

Gestion des issues : list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Projets & Équipes : 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

Workflows pratiques

Sprint Planning : Passez en revue les issues ouvertes pour une équipe cible, choisissez les meilleurs éléments par priorité et créez un nouveau cycle (par ex. « Q1 Performance Sprint ») avec des affectations.
Bug Triage : Listez les bugs critiques/haute priorité, classez par impact utilisateur et déplacez les meilleurs éléments vers « In Progress ».
Documentation Audit : Recherchez de la documentation (par ex. auth d'API), puis ouvrez des issues libellées « documentation » pour les lacunes ou sections obsolètes avec des corrections détaillées.
Team Workload Balance : Regroupez les issues actives par responsable, signalez quiconque avec une charge élevée et suggérez ou appliquez des redistributions.
Release Planning : Créez un projet (par ex. « v2.0 Release ») avec des jalons (gel des fonctionnalités, bêta, docs, lancement) et générez des issues avec des estimations.
Cross-Project Dependencies : Trouvez toutes les issues « bloquées », identifiez les blocages et créez des issues liées si manquantes.
Automated Status Updates : Trouvez vos issues avec des mises à jour obsolètes et ajoutez des commentaires de statut en fonction de l'état actuel/blocages.
Smart Labeling : Analysez les issues sans label, suggérez/appliquez des labels et créez les catégories de labels manquantes.
Sprint Retrospectives : Générez un rapport pour le cycle terminé le plus récent, notez le travail complété vs décalé et ouvrez des issues de discussion pour les patterns.

Conseils pour une productivité maximale

Regroupez les opérations pour les modifications connexes ; envisagez des templates intelligents pour les structures d'issues récurrentes.
Utilisez des requêtes en langage naturel quand possible (« Montre-moi sur quoi John travaille cette semaine »).
Exploitez le contexte : référencez les issues antérieures dans les nouvelles demandes.
Divisez les grandes mises à jour 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, relancez OAuth, vérifiez les permissions de l'espace de travail, assurez-vous que l'accès à l'API est activé.
Erreurs d'appel d'outils : Confirmez que le modèle supporte les appels d'outils multiples, fournissez tous les champs requis et divisez les requêtes complexes.
Données manquantes : Actualisez le token, vérifiez l'accès à l'espace de travail, recherchez 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 ; regroupez les opérations en masse, utilisez des filtres spécifiques ou mettez en cache les requêtes fréquentes.