htekdev/actions-debugger

O que actions-debugger faz?

Mais de 65 erros reais do GitHub Actions, consultáveis por agentes. Servidor MCP + habilidades Copilot + banco de erros.

Visão Geral

Este skill fornece um repositório de erros comuns do GitHub Actions, juntamente com soluções e explicações. Os agentes podem consultar o banco de erros por mensagem de erro ou sintoma, e receber a causa raiz correspondente e orientações de correção.

Recursos

• 65+ erros documentados – Cada erro inclui descrição, causa provável e solução.
• Servidor MCP – Permite que agentes compatíveis (Claude Code, Cursor, Codex) consultem o banco de forma programática.
• Habilidades Copilot – Atalhos para pesquisar erros diretamente no editor.
• Fácil integração – Basta conectar o servidor MCP ao agente desejado.

Como usar

Para agentes MCP

Configure o servidor MCP no seu agente:

{
  "mcpServers": {
    "actions-debugger": {
      "command": "npx",
      "args": ["@htekdev/actions-debugger"],
      "env": {}
    }
  }
}

Para GitHub Copilot

Instale a extensão Actions Debugger no VS Code e use comandos como:

• @actions-debugger erro: "Process completed with exit code 1"
• @actions-debugger ajuda: "The operation was canceled"

Exemplo de consulta

Entrada do agente:

Erro: "error: failed to push some refs to"

Resposta do skill:

Causa: Tentativa de push para um branch que contém commits remotos não presentes localmente. Solução: Execute git pull --rebase e tente novamente.

Estrutura do banco de erros

Cada erro é armazenado no formato:

- id: "ERRO-001"
  mensagem: "Process completed with exit code 1"
  sintomas: ["Falha genérica", "Erro inesperado"]
  causa: "Ocorreu um erro não capturado no script."
  solucao: "Verifique os logs do workflow para mais detalhes. Adicione tratamento de erro adequado."

Contribuindo

Veja CONTRIBUTING.md para detalhes sobre como adicionar novos erros ao banco.

Licença

MIT