Linear

Linear

Visão Geral

Esta skill oferece um workflow estruturado para gerenciar issues, projetos e workflows de equipe no Linear. Ela garante integração consistente com o servidor Linear MCP, que fornece gerenciamento de projetos em linguagem natural para issues, projetos, documentação e colaboração em equipe.

Pré-requisitos

• O servidor Linear MCP deve estar conectado e acessível via OAuth
• Confirme o acesso ao workspace, equipes e projetos relevantes do Linear

Workflow Obrigatório

Siga estas etapas na ordem. Não pule etapas.

Etapa 0: Configurar Linear MCP (se ainda não estiver configurado)

Se qualquer chamada MCP falhar porque Linear MCP não está conectado, pause e configure:

1. Adicione o Linear MCP:
   • codex mcp add linear --url https://mcp.linear.app/mcp
2. Ative o cliente MCP remoto:
   • Defina [features] rmcp_client = true em config.toml ou execute codex --enable rmcp_client
3. Faça login com OAuth:
   • codex mcp login linear

Após o login bem-sucedido, o usuário terá que reiniciar o codex. Você deve finalizar sua resposta e informá-lo que quando tentar novamente poderá prosseguir com a Etapa 1.

Nota para Windows/WSL: Se você ver erros de conexão no Windows, tente configurar o Linear MCP para ser executado via WSL:

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

Etapa 1

Esclareça o objetivo e escopo do usuário (ex: triagem de issues, planejamento de sprint, auditoria de documentação, balanceamento de carga de trabalho). Confirme equipe/projeto, prioridade, labels, ciclo e datas de vencimento conforme necessário.

Etapa 2

Selecione o workflow apropriado (veja Workflows Práticos abaixo) e identifique as ferramentas Linear MCP que você precisará. Confirme os identificadores necessários (ID do issue, ID do projeto, chave da equipe) antes de chamar as ferramentas.

Etapa 3

Execute chamadas de ferramentas Linear MCP em lotes lógicos:

• Leia primeiro (list/get/search) para construir contexto.
• Crie ou atualize em seguida (issues, projetos, labels, comentários) com todos os campos obrigatórios.
• Para operações em massa, explique a lógica de agrupamento antes de aplicar mudanças.

Etapa 4

Resuma os resultados, destaque lacunas ou bloqueadores restantes e proponha próximas ações (issues adicionais, mudanças de labels, atribuições ou comentários de acompanhamento).

Ferramentas Disponíveis

Gerenciamento de Issues: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Projeto & Equipe: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Documentação & Colaboração: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Workflows Práticos

• Planejamento de Sprint: Revise issues abertos para uma equipe alvo, escolha os principais itens por prioridade e crie um novo ciclo (ex: "Sprint de Performance Q1") com atribuições.
• Triagem de Bugs: Liste bugs críticos/de alta prioridade, classifique por impacto do usuário e mova os principais itens para "In Progress".
• Auditoria de Documentação: Pesquise documentação (ex: autenticação de API), depois abra issues marcadas com "documentation" para lacunas ou seções desatualizadas com correções detalhadas.
• Balanceamento de Carga de Trabalho da Equipe: Agrupe issues ativas por responsável, sinalize qualquer um com carga alta e sugira ou aplique redistribuições.
• Planejamento de Release: Crie um projeto (ex: "Release v2.0") com milestones (congelamento de funcionalidades, beta, docs, lançamento) e gere issues com estimativas.
• Dependências Entre Projetos: Encontre todos os issues "bloqueados", identifique os bloqueadores e crie issues vinculados se faltarem.
• Atualizações de Status Automatizadas: Encontre seus issues com atualizações antigas e adicione comentários de status baseados no estado atual/bloqueadores.
• Etiquetagem Inteligente: Analise issues sem label, sugira/aplique labels e crie categorias de labels faltantes.
• Retrospectivas de Sprint: Gere um relatório do último ciclo concluído, observe trabalho concluído vs. adiado e abra issues de discussão para padrões.

Dicas para Produtividade Máxima

• Agrupe operações por mudanças relacionadas; considere templates inteligentes para estruturas de issues recorrentes.
• Use queries em linguagem natural quando possível ("Mostre-me o que João está trabalhando esta semana").
• Aproveite o contexto: referencie issues anteriores em novas solicitações.
• Quebre grandes atualizações em lotes menores para evitar limites de taxa; armazene em cache ou reutilize filtros ao listar com frequência.

Solução de Problemas

• Autenticação: Limpe cookies do navegador, execute novamente OAuth, verifique permissões de workspace, garanta que o acesso à API esteja habilitado.
• Erros ao Chamar Ferramentas: Confirme que o modelo suporta múltiplas chamadas de ferramentas, forneça todos os campos obrigatórios e divida solicitações complexas.
• Dados Faltando: Atualize o token, verifique o acesso ao workspace, procure por projetos arquivados e confirme a seleção correta de equipe.
• Performance: Lembre-se dos limites de taxa da API Linear; agrupe operações em massa, use filtros específicos ou armazene consultas frequentes em cache.