xoykor

quebra-de-loop

Check automatizado contra loops de investigacao redundante e guia para quebrar o loop. Antes de cada passo de investigacao, verifique se ha evidencia suficiente para a proxima acao autorizada; se nao, produza evidencia nova ou peca apenas os dados faltantes — nunca repita leituras equivalentes.

xoykor 1 Updated 1mo ago
GitHub

Install

npx skillscat add xoykor/dsh-backup/quebra-de-loop

Install via the SkillsCat registry.

SKILL.md

Quebra de Loop (Check)

Regra central

Proibido repetir uma investigacao que ja respondeu a mesma pergunta sobre o mesmo
estado relevante, sem evidencia nova capaz de mudar a decisao. Trocar palavras da
busca, ferramenta, agente ou ordem de leitura nao torna a investigacao nova.

Quando houver evidencia suficiente para a proxima acao autorizada, execute-a.
Nao exija certeza sobre todo o sistema para fazer uma mudanca delimitada.

O check (rodar antes de cada passo)

  1. Identifique a pergunta ainda nao respondida e a decisao concreta que sua
    resposta pode alterar.
  2. Confirme se as evidencias ja disponiveis na conversa/checkpoint respondem-na.
  3. Se respondidas e o estado relevante nao mudou, reutilize a conclusao — pare.

Transicao para execucao (evidencia suficiente)

Passe a implementacao quando estiver definidos: comportamento solicitado, local da
mudanca e uma validacao proporcional — sem bloqueio material de autorizacao ou
correcao pendente. Nao transforme incerteza de runtime em novas rodadas de leitura
estatica que nao podem resolvê-la.

Quebrar o loop (quando falta informacao)

  • Procure uma mudanca observavel relevante para a decisao. Trocar de ferramenta,
    consultar mtime/tamanho ou procurar um PID nao cria evidencia por si so e nao
    contorna um bloqueio do executor.
  • Se faltar dado indispensavel para agir corretamente, peça APENAS esse dado — o
    que nao pode ser obtido dentro das restricoes vigentes. Nao devolva ao usuario
    trabalho que se poderia executar sozinho.
  • Relate estado duravel + proxima acao concreta em vez de ler logs repetidamente.

Espera por job gerenciado

Esperar com job_output e wait:true pelo mesmo job_id ainda ativo e uma
observacao neutra quando reconhecida pelo executor. Nao e investigacao repetida,
nem prova de progresso ou sucesso. Siga a skill acompanhamento: espera nativa
limitada, notificacoes e coleta do resultado terminal. Leituras rapidas repetidas,
logs estaticos e troca de ferramentas continuam sujeitos ao guard.

Validacao (nao e rediagnostico)

Execute a verificacao minima capaz de detectar a falha relevante. Se passar e os
requisitos estiverem atendidos, conclua. Nao alegue sucesso de runtime por inspecao
estatica sozinha; nao reabra buscas equivalentes para compensar um teste indisponivel.

Encerramento

Informe o que foi alterado, como foi validado e limitacoes materiais restantes.
Nao encerre so porque parou de investigar se ainda houver implementacao autorizada
e viavel a fazer.

Categories