Communitygithub.com

zhaidewei/keep-or-sweep

Mantenha, corrija, arquive ou remova—uma Skill de Agente baseada em evidências.

O que é keep-or-sweep?

A skill zhaidewei/keep-or-sweep oferece um fluxo estruturado para auditores (humanos ou agentes de IA) avaliarem um único ativo bem delimitado, determinando se ele deve ser mantido, reparado/substituído, arquivado ou excluído. Em vez de varrer todo um ecossistema, a skill foca em um ativo por auditoria, coletando evidências sobre consumidores reais, dependências, cópias geradas e deveres de retenção. Baseia-se em um teste de contrafactual de exclusão: se o ativo sumir, o comportamento observável de usuários ou agentes piora? Com base na resposta e na credibilidade do mecanismo de manutenção, uma das cinco disposições é recomendada. A skill é compatível com agentes que executam comandos, leem arquivos, acessam APIs ou editam configurações, e alerta explicitamente que recomendar exclusão não autoriza a executá-la — é necessário verificar permissões e método de recuperação antes de qualquer ação irreversível. O fluxo inclui um gráfico de decisão Mermaid e enfatiza que evidências ausentes ou consumidores desconhecidos não significam que o ativo não está em uso; quando em dúvida, pausa-se e identifica-se a menor verificação seguinte que possa mudar a disposição.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

Perguntar na sua IA favorita

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

Documentação

Manter ou Remover

Audite um ativo claramente delimitado. Não transforme isso em um exercício de desduplicação ou home canônico de todo o ecossistema.

Fluxo de Trabalho

  1. Delimite o ativo. Nomeie o alvo exato, proprietário ou autoridade, operações permitidas e limite de impacto. Se a requisição contiver múltiplos ativos independentes, selecione um alvo claro para esta auditoria e liste os demais como fora de escopo. Não continue pela lista na mesma auditoria.
  2. Inventário somente leitura. Encontre consumidores reais, chamadores, gatilhos, dependências, entradas, saídas, contratos, cópias geradas, histórico, deveres de retenção e uso em tempo de execução. Pesquise nomes e comportamento; uso dinâmico e permissões indisponíveis permanecem desconhecidos.
  3. Teste o contrafactual de exclusão. Indique qual comportamento observável de usuário ou agente pioraria se o ativo desaparecesse. Correspondência de nome ou formato semelhante não prova redundância.
  4. Classifique seu papel. Fonte da verdade, projeção e adaptador são papéis, não vereditos. Para uma projeção, verifique valor específico para o consumidor, consistência com sua fonte, regeneração ou sincronização, e um mecanismo de manutenção com proprietário, gatilho, detecção de desvio e caminho de reparo.
  5. Escolha exatamente uma disposição.
    • Manter: tem valor evidenciado e um mecanismo de manutenção confiável.
    • Reparar ou substituir: tem usuários evidenciados, mas seu mecanismo atual não é confiável.
    • Arquivar: uso ativo ausente, mas existe dever de retenção legal, histórico, auditoria ou contratual.
    • Excluir: nenhum comportamento observável piora e nenhum dever de retenção se aplica. Esta é uma recomendação; não autoriza execução.
    • Pausar: evidências, permissões, autorização, recuperabilidade ou análise de risco irreversível são insuficientes.
  6. Execute apenas dentro da autoridade. Auditoria somente leitura nunca implica permissão para excluir, sobrescrever, alterar estado remoto ou fazer uma mudança irreversível. Antes da exclusão, nomeie o método de recuperação. Após a exclusão, verifique os consumidores esperados e relate qualquer coisa ainda não comprovada.

Árvore de decisão

flowchart TD
    A["Delimite um ativo<br/>e faça inventário somente leitura"] --> B{"Evidências suficientes?"}
    B -- "Não" --> P["Pause e nomeie<br/>a evidência faltante"]
    B -- "Sim" --> C{"A exclusão pioraria<br/>o comportamento observável?"}
    C -- "Desconhecido" --> P
    C -- "Não" --> D{"Dever de retenção?"}
    D -- "Sim" --> R["Arquivar"]
    D -- "Não" --> X["Recomendar exclusão"]
    C -- "Sim" --> F{"Mecanismo de manutenção<br/>confiável?"}
    F -- "Sim" --> K["Manter"]
    F -- "Não" --> N["Reparar ou substituir"]

Consumidores desconhecidos, chamadas dinâmicas, acesso ausente e evidência faltante não significam que não está em uso. Quando em dúvida, pause e identifique a menor verificação seguinte que poderia mudar a disposição.

Habilidades Relacionadas