skillgram-report

Reporte um bug do skillgram ou uma lacuna de skill ausente com evidências reais: escolha o canal, capture o JSON, abra a issue.

O que é skillgram-report?

Esta skill do skillgram permite que um agente de IA reporte bugs ou lacunas de habilidades (skills) faltantes com evidências concretas e reproduzíveis. Ela é útil para desenvolvedores que utilizam o skillgram como gerenciador de habilidades para agentes (como Claude Code, Cursor, Codex) e precisam de uma forma confiável e padronizada de reportar problemas: desde falhas na instalação ou registro de skills até comandos que retornam `ok:false` ou `found:false`. A skill suporta a execução em qualquer ambiente que tenha o skillgram instalado, incluindo múltiplos harnesses (configurações de MCP). Ela funciona seguindo um fluxo de reprodução rigoroso: captura o comando exato, o código de saída, o ambiente (SO, Python, versão do skillgram, harness, launcher), e coleta evidências como `skillgram status --json`, `skillgram doctor --json` e `skillgram missing --json`. Em seguida, determina se o problema é um bug (canal `bug`) ou uma solicitação de skill (canal `skill-request`), e compõe uma issue a partir de um template, permitindo postá-la via `gh issue create` ou disponibilizando o texto para o usuário. Regras importantes incluem nunca editar manualmente configs do harness para ocultar o bug, redatar tokens e senhas antes de colar, e nunca inventar evidências.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Xhuk/skillgram/tree/HEAD/skills/skillgram-report

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação


name: skillgram-report description: Reporte um bug do skillgram ou uma lacuna de skill ausente com evidências reais: escolha o canal, capture o JSON, abra a issue.

O que skillgram-report faz?

Contrato de Ativação

Use esta skill quando uma das seguintes situações for verdadeira:

  • skillgram imprimiu ok:false, saiu com código 1/2, travou, ou disse algo que o disco contradiz (registered sem entrada na configuração do harness, um link que não leva a lugar nenhum, um mount que reportou zero skills enquanto o manifest tem algumas).
  • um agente precisava de uma capacidade e skillgram missing "<query>" respondeu found:false.
  • uma instalação ou registro não teve efeito no harness após o restart documentado.

Não para: "como executar X" (leia INSTALL.md), ou uma ideia de funcionalidade sem lacuna observada.

Regras Rígidas

  1. Um bug nunca é arquivado como skill. Nunca execute propose para encobrir um comportamento quebrado.
  2. Uma lacuna nunca é arquivada como bug. Nada no hub para uma capacidade é uma solicitação.
  3. Nenhuma evidência inventada: todo código de saída, caminho e linha JSON vêm de um comando que você executou agora.
  4. Redija antes de colar: tokens, senhas, hosts privados, nomes de clientes. Mantenha a forma, altere os valores.
  5. Nunca "corrija" o skillgram editando manualmente uma configuração de harness (config.toml, config.yaml, .claude.json, .cursor/mcp.json) para compensar. Isso esconde o bug.
  6. Leia a configuração de volta antes de afirmar sucesso: <harness> mcp get skillgram (ou mcp list) e skillgram status. Um código de saída não é prova.

Portões de Decisão

ObservaçãoCanal
ok:false, código de saída não zero, link errado, mentira na saída, travamentobug → bug_report.yml
found:false para uma capacidade que você realmente precisavasolicitação de skill → skill_request.yml
A coisa faltante é um comando, flag ou comportamento do skillgram, não uma skillbug (diga "funcionalidade" no título)
Funciona em outra máquina ou harnessanote como evidência; não é uma correção
Incertezacolete ambas as evidências e deixe o usuário escolher o canal

Passos de Execução

  1. Reproduza uma vez, mantendo a linha de comando exata. Use a CLI (skillgram <comando> --json, ou python <repo>/skillgram.py <comando> --json quando não estiver instalado) e registre o código de saída ($LASTEXITCODE no PowerShell, $? no POSIX).
  2. Capture o ambiente:
    • skillgram status --json
    • skillgram doctor --json (somente leitura; remova caminhos que você não quer públicos)
    • SO, versão do Python, versão do skillgram, o harness, e o launcher que você usou (SKILLGRAM_MCP_CLI_<HARNESS> quando o que está no PATH não for o correto).
  3. Para qualquer alegação de registro, capture <harness> mcp get skillgram (ou mcp list) após o comando que alegou sucesso.
  4. Para uma lacuna, capture skillgram missing "<query>" --json e skillgram demand --limit 20 (ele classifica as consultas que ninguém conseguiu responder, para que a issue e o log de demanda estejam alinhados).
  5. Componha a issue a partir do template e mostre-a ao usuário antes de postar. Poste com gh issue create --repo Xhuk/skillgram --template bug_report.yml (ou --body-file <arquivo> quando você mesmo preencher o formulário), ou entregue o texto.

Contrato de Saída

Responda exatamente com:

  • canal: bug ou skill-request
  • evidência: o comando, o código de saída, uma linha JSON
  • ambiente: SO / Python / skillgram / harness / launcher
  • esperado em vez disso: uma frase, sem especulação
  • disposição: postado (com a URL da issue) ou deixado como texto para o usuário

Habilidades Relacionadas