ComposioHQ/linear

O que linear faz?

Visão Geral

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

Pré-requisitos

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

Fluxo de Trabalho Obrigatório

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

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

Se alguma chamada MCP falhar porque o MCP do Linear não está conectado, pare e configure-o:

1. Adicione o MCP do Linear:
   • codex mcp add linear --url https://mcp.linear.app/mcp
2. Habilite 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 precisará reiniciar o codex. Você deve finalizar sua resposta e informá-los para que, ao tentar novamente, possam continuar com a Etapa 1.

Observação para Windows/WSL: Se você encontrar erros de conexão no Windows, tente configurar o MCP do Linear para executar 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 o escopo do usuário (por exemplo, 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 fluxo de trabalho apropriado (consulte Fluxos de Trabalho Práticos abaixo) e identifique as ferramentas MCP do Linear 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 MCP do Linear em lotes lógicos:

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

Etapa 4

Resuma os resultados, aponte lacunas ou bloqueios restantes e proponha próximas ações (issues adicionais, alterações 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 e Equipe: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

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

Fluxos de Trabalho Práticos

• Planejamento de Sprint: Revise issues abertas para uma equipe alvo, escolha os itens principais por prioridade e crie um novo ciclo (ex.: "Sprint de Performance Q1") com atribuições.
• Triagem de Bugs: Liste bugs críticos/alta prioridade, classifique por impacto no usuário e mova os itens principais para "Em Andamento".
• Auditoria de Documentação: Pesquise na documentação (ex.: autenticação da API) e depois abra issues rotuladas como "documentação" para lacunas ou seções desatualizadas com correções detalhadas.
• Balanceamento de Carga da Equipe: Agrupe issues ativas por responsável, sinalize qualquer um com alta carga e sugira ou aplique redistribuições.
• Planejamento de Release: Crie um projeto (ex.: "Release v2.0") com marcos (congelamento de funcionalidades, beta, docs, lançamento) e gere issues com estimativas.
• Dependências Entre Projetos: Encontre todos os issues "bloqueados", identifique bloqueadores e crie issues vinculados se estiverem faltando.
• Atualizações Automáticas de Status: Encontre seus issues com atualizações desatualizadas e adicione comentários de status com base no estado/bloqueadores atuais.
• Rotulagem Inteligente: Analise issues não rotulados, sugira/aplique labels e crie categorias de labels ausentes.
• Retrospectivas de Sprint: Gere um relatório para o último ciclo concluído, anote o trabalho concluído vs. o empurrado e abra issues de discussão para padrões.

Dicas para Máxima Produtividade

• Agrupe operações para alterações relacionadas; considere modelos inteligentes para estruturas recorrentes de issues.
• Use consultas em linguagem natural quando possível ("Mostre-me no que João está trabalhando esta semana").
• Aproveite o contexto: referencie issues anteriores em novas solicitações.
• Divida atualizações grandes 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 os cookies do navegador, execute o OAuth novamente, verifique as permissões do workspace, confirme se o acesso à API está habilitado.
• Erros de Chamada de Ferramenta: Confirme que o modelo suporta múltiplas chamadas de ferramenta, forneça todos os campos obrigatórios e divida solicitações complexas.
• Dados Ausentes: Atualize o token, verifique o acesso ao workspace, verifique projetos arquivados e confirme a seleção correta da equipe.
• Desempenho: Lembre-se dos limites de taxa da API Linear; agrupe operações em lote, use filtros específicos ou armazene em cache consultas frequentes.