pin-the-case-that-narrowed-the-rule
Cuando una comprobación salta sobre el objetivo equivocado, el arreglo la debilita. Captura el falso positivo como prueba en el mismo commit, o la regla se erosiona en silencio.
Conferida por quien revisó y leyó la tarjeta, no reclamada por el propio archivo. Una tarjeta que el agente destila durante una ejecución que consumió contenido no confiable nace contaminada y queda retenida para revisión antes de ser recuperada.
Cuándo viene a la mente
- el linter marcó algo legítimo
- agregando una excepción
- falso positivo en CI
- relajando una comprobación
Evita y Comprueba es donde suele estar el valor. Haz es la sección que todo el mundo escribe.
El cuerpo de la tarjeta de arriba es una traducción. El original en inglés es lo que importa la CLI, lo que lee el agente en ejecución y lo que atestigua el hash de abajo.
Disparador
Una verificación que escribiste ha fallado en algo que en realidad está bien, y estás a punto de añadir una excepción, una entrada en una lista de permitidos, o un patrón más estrecho.
No aplica cuando la verificación encontró un problema real — corrige el problema. Tampoco aplica a ajustar un umbral antes de que la verificación haya corrido alguna vez en serio.
Haz
- Anota, en una frase, por qué el caso marcado es legítimo. Si no puedes, es posible que la verificación tenga razón y el código esté equivocado.
- Añade ambos casos a la suite de pruebas: el legítimo que debe pasar, y una versión sintética de la violación real que debe seguir fallando.
- Estrecha la regla lo menos posible. Exime una ruta, no un directorio entero; exige una negación cercana, en lugar de eliminar la frase de la lista.
- Coloca el estrechamiento en su propio commit, y di en el mensaje qué caso lo forzó.
Evita
Eliminar la regla porque fue molesta una vez. Evita también la versión más silenciosa: ampliar una excepción hasta que la regla no cubra nada — una lista de permitidos que crece cada sprint es una regla siendo retirada una línea a la vez, sin que nadie decida retirarla.
Evita eximir por archivo cuando la distinción real es por significado. Una verificación de frases que prohíbe una oración por completo prohibirá también la advertencia que la niega, y la corrección honesta es exigir la negación, no dejar de verificar esa página.
Comprueba
Después de estrechar, ejecuta la suite con la violación original reintroducida. Debe seguir fallando.
Luego lee el diff de la regla misma y pregúntate: ¿qué clase de problema puede ahora pasar que antes no podía? Si no puedes responder, el estrechamiento no fue comprendido.
Riesgo
Esto añade una prueba por cada excepción, y una suite llena de pruebas de excepción es una suite tediosa de leer.
El riesgo mayor es tratar la prueba fijada como prueba de que la regla sigue siendo fuerte. Solo prueba que un caso sigue fallando. Una regla estrechada cinco veces tiene cinco casos fijados y posiblemente un gran hueco entre ellos, y solo releer la regla en su conjunto lo mostrará.
Cómo usarla
La tarjeta es un dato. Clona el repositorio e impórtala por ruta: lo que llega por la red se trata como contaminado y queda retenido a la espera de aprobación, que es el comportamiento deseable y la razón por la que aquí no hay un instalador de una línea.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/pin-the-case-that-narrowed-the-rule/SKILL.mdIntegridad
SHA-256 del archivo tal como se publicó. Quien lo importe puede comprobar que lo que recibió es lo que mostró esta página.
9ae6da37eebf345c4dc4df56dd7506b00ea89e8ee74738afa8ffeab7a56bf0ed