ComposioHQ/issue-triage

Triagem de Issues (Linear / Jira)

Realize sessões de triagem e varreduras de bugs no Linear ou Jira com o Composio CLI. Puxe o backlog, agrupe duplicatas, aplique etiquetas e entregue uma lista limpa para a equipe.

Quando Usar

• Triagem semanal: "o que está não atribuído, obsoleto ou sem prioridade?"
• Varredura de bugs após lançamento: "agrupe todos os bugs P1/P2, deduplique, atribua responsáveis."
• Sincronização entre ferramentas: Sentry → Linear, PagerDuty → Jira.

Pré-requisitos

curl -fsSL https://composio.dev/install | bash
composio login
composio link linear        # ou: composio link jira

Descobrir Ferramentas

composio search "list issues" --toolkits linear
composio search "search issues" --toolkits jira
composio tools list linear
composio tools list jira

Slugs comuns (verifique com --get-schema):

Linear

• LINEAR_LIST_ISSUES
• LINEAR_CREATE_ISSUE
• LINEAR_UPDATE_ISSUE
• LINEAR_CREATE_COMMENT

Jira

• JIRA_SEARCH_FOR_ISSUES_USING_JQL
• JIRA_CREATE_ISSUE
• JIRA_EDIT_ISSUE
• JIRA_ADD_COMMENT
• JIRA_ASSIGN_ISSUE

Fluxo de Triagem

1. Puxe o subconjunto do backlog:

   # Linear
   composio execute LINEAR_LIST_ISSUES -d '{
     "filter": { "state": { "type": { "eq": "unstarted" } }, "assignee": { "null": true } },
     "first": 100
   }'
   
   # Jira
   composio execute JIRA_SEARCH_FOR_ISSUES_USING_JQL -d '{
     "jql": "project = APP AND statusCategory != Done AND assignee is EMPTY ORDER BY updated DESC",
     "maxResults": 100,
     "fields": ["summary","priority","labels","updated","reporter"]
   }'
   

2. Agrupe por similaridade de título e etiquetas. O agente agrupa duplicatas prováveis localmente.
3. Aplique atualizações em uma única passada (etiqueta, prioridade, responsável):

   composio execute LINEAR_UPDATE_ISSUE -d '{
     "id":"abc-123","priority":2,"labelIds":["label-bug","label-p1"],"assigneeId":"user-42"
   }'
   
   composio execute JIRA_EDIT_ISSUE -d '{
     "issueIdOrKey":"APP-482",
     "fields":{"priority":{"name":"High"},"labels":["bug","p1"]}
   }'
   

4. Vincule duplicatas com comentários referenciando a issue canônica.
5. Publique um resumo do que foi alterado no Slack para que a equipe veja o resultado da varredura.

Varredura de Bugs (Pós-Lançamento)

# Jira: todo bug registrado nos últimos 7 dias, ordenado por severidade
composio execute JIRA_SEARCH_FOR_ISSUES_USING_JQL -d '{
  "jql":"type = Bug AND created >= -7d ORDER BY priority DESC, created ASC",
  "fields":["summary","priority","labels","reporter","components"]
}' | jq -r '.issues[] | "\(.fields.priority.name)\t\(.key)\t\(.fields.summary)"'

Arquivo de Fluxo de Trabalho

scripts/triage-linear.ts, execute com composio run --file scripts/triage-linear.ts:

const { nodes: issues } = await execute("LINEAR_LIST_ISSUES", {
  filter: { state: { type: { eq: "unstarted" } }, assignee: { null: true } },
  first: 100
});

const stale = issues.filter(i => {
  const age = (Date.now() - new Date(i.updatedAt).getTime()) / 86400000;
  return age > 14;
});

for (const i of stale) {
  await execute("LINEAR_CREATE_COMMENT", {
    issueId: i.id,
    body: "Triagem automática: obsoleto por 14+ dias. Por favor, atribua ou feche."
  });
}

await execute("SLACK_SEND_MESSAGE", {
  channel: "triage",
  text: `Triagem semanal: notificou ${stale.length} issues obsoletas.`
});

Ferramenta Cruzada: Sentry → Linear

composio run '
  const hot = await execute("SENTRY_LIST_A_PROJECTS_ISSUES", {
    organization_slug:"acme", project_slug:"api",
    query:"is:unresolved", sort:"freq", limit:5
  });
  for (const s of hot) {
    await execute("LINEAR_CREATE_ISSUE", {
      teamId: "TEAM_ID",
      title: `[Sentry] ${s.title}`,
      description: `${s.permalink}\nCount: ${s.count}`,
      labelIds: ["label-bug","label-from-sentry"]
    });
  }
'

Solução de Problemas

• Nomes de campos desconhecidos → composio execute <SLUG> --get-schema mostra a forma exata do filtro (Linear usa objetos aninhados; Jira usa strings JQL).
• 403 no Linear → execute novamente composio link linear com o workspace correto.
• Campos personalizados do Jira ausentes → solicite-os explicitamente no array fields.
• Edições em lote com limite de taxa → insira um atraso de 250ms no loop composio run; não use --parallel.

Referência completa do CLI: docs.composio.dev/docs/cli