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ódigo1/2, travou, ou disse algo que o disco contradiz (registeredsem 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>"respondeufound: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
- Um bug nunca é arquivado como skill. Nunca execute
proposepara encobrir um comportamento quebrado. - Uma lacuna nunca é arquivada como bug. Nada no hub para uma capacidade é uma solicitação.
- Nenhuma evidência inventada: todo código de saída, caminho e linha JSON vêm de um comando que você executou agora.
- Redija antes de colar: tokens, senhas, hosts privados, nomes de clientes. Mantenha a forma, altere os valores.
- 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. - Leia a configuração de volta antes de afirmar sucesso:
<harness> mcp get skillgram(oumcp list) eskillgram status. Um código de saída não é prova.
Portões de Decisão
| Observação | Canal |
|---|---|
ok:false, código de saída não zero, link errado, mentira na saída, travamento | bug → bug_report.yml |
found:false para uma capacidade que você realmente precisava | solicitação de skill → skill_request.yml |
| A coisa faltante é um comando, flag ou comportamento do skillgram, não uma skill | bug (diga "funcionalidade" no título) |
| Funciona em outra máquina ou harness | anote como evidência; não é uma correção |
| Incerteza | colete ambas as evidências e deixe o usuário escolher o canal |
Passos de Execução
- Reproduza uma vez, mantendo a linha de comando exata. Use a CLI (
skillgram <comando> --json, oupython <repo>/skillgram.py <comando> --jsonquando não estiver instalado) e registre o código de saída ($LASTEXITCODEno PowerShell,$?no POSIX). - Capture o ambiente:
skillgram status --jsonskillgram 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á noPATHnão for o correto).
- Para qualquer alegação de registro, capture
<harness> mcp get skillgram(oumcp list) após o comando que alegou sucesso. - Para uma lacuna, capture
skillgram missing "<query>" --jsoneskillgram demand --limit 20(ele classifica as consultas que ninguém conseguiu responder, para que a issue e o log de demanda estejam alinhados). - 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:
bugouskill-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