Communitygithub.com

zhaidewei/keep-or-sweep

Conserva o barre—una habilidad de agente basada en evidencias para auditar un activo claramente delimitado.

¿Qué es keep-or-sweep?

Esta habilidad proporciona un proceso estructurado para que un agente de IA audite un activo único y claramente delimitado, ayudando a decidir si mantenerlo, repararlo/reemplazarlo, archivarlo o eliminarlo. Se centra en la evaluación basada en evidencias, asegurando que las decisiones estén respaldadas por datos observables y no por suposiciones. La habilidad guía al agente a través de un flujo de trabajo paso a paso: delimitar el activo, realizar un inventario de solo lectura, probar el escenario contrafáctico de eliminación, clasificar el rol del activo y, finalmente, seleccionar una disposición exacta. Es compatible con cualquier plataforma de agente (como Claude Code, Cursor o Codex) y utiliza lógica basada en reglas para evitar que el agente realice acciones no autorizadas, requiriendo autorización explícita para cualquier modificación irreversible. El flujo de trabajo enfatiza la precaución, sugiriendo pausar si no hay evidencia suficiente o si los riesgos son irreversibles, y exige nombrar un método de recuperación antes de cualquier eliminación.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Conserva o Barre

Audita un activo claramente delimitado. No conviertas esto en un ejercicio de deduplicación ni de búsqueda de un hogar canónico en todo el dominio.

Flujo de trabajo

  1. Delimita el activo. Nombra el objetivo exacto, su propietario o autoridad, las operaciones permitidas y el límite de impacto. Si la solicitud contiene múltiples activos independientes, selecciona un objetivo claro para esta auditoría y enumera los demás como fuera de alcance. No continúes la auditoría para revisar toda la lista.
  2. Inventario de solo lectura. Encuentra consumidores reales, invocadores, disparadores, dependencias, entradas, salidas, contratos, copias generadas, historial, obligaciones de retención y uso en tiempo de ejecución. Busca nombres y comportamiento; el uso dinámico y los permisos no disponibles permanecen desconocidos.
  3. Prueba el escenario contrafáctico de eliminación. Indica qué comportamiento observable de usuario o agente empeoraría si el activo desapareciera. Una coincidencia de nombre o forma similar no prueba redundancia.
  4. Clasifica su rol. Una fuente de verdad, proyección y adaptador son roles, no veredictos. Para una proyección, verifica el valor específico para el consumidor, la coherencia con su fuente, la regeneración o sincronización, y un mecanismo de mantenimiento con un propietario, disparador, detección de desviaciones y ruta de reparación.
  5. Elige exactamente una disposición.
    • Conservar: tiene valor evidenciado y un mecanismo de mantenimiento creíble.
    • Reparar o reemplazar: tiene usuarios evidenciados pero su mecanismo actual no es confiable.
    • Archivar: el uso en vivo está ausente, pero existe una obligación de retención legal, histórica, de auditoría o contractual.
    • Eliminar: ningún comportamiento observable empeora y no aplica ninguna obligación de retención. Esto es una recomendación; no autoriza la ejecución.
    • Pausar: la evidencia, los permisos, la autorización, la recuperabilidad o el análisis de riesgo irreversible son insuficientes.
  6. Ejecuta solo dentro de la autoridad. Una auditoría de solo lectura nunca implica permiso para eliminar, sobrescribir, mutar estado remoto o realizar un cambio irreversible. Antes de eliminar, nombra el método de recuperación. Después de eliminar, verifica los consumidores esperados e informa cualquier cosa que aún no esté probada.

Árbol de decisión

flowchart TD
    A["Delimita un activo<br/>e inventario de solo lectura"] --> B{"¿Evidencia suficiente?"}
    B -- "No" --> P["Pausa y nombra<br/>la evidencia faltante"]
    B -- "Sí" --> C{"¿Empeoraría la eliminación<br/>el comportamiento observable?"}
    C -- "Desconocido" --> P
    C -- "No" --> D{"¿Obligación de retención?"}
    D -- "Sí" --> R["Archivar"]
    D -- "No" --> X["Recomendar eliminación"]
    C -- "Sí" --> F{"¿Mecanismo de mantenimiento<br/>creíble?"}
    F -- "Sí" --> K["Conservar"]
    F -- "No" --> N["Reparar o reemplazar"]

Consumidores desconocidos, llamadas dinámicas, acceso faltante y evidencia ausente no significan que no esté en uso. Cuando tengas dudas, pausa e identifica la verificación más pequeña que podría cambiar la disposición.

Skills relacionados