Communitygithub.com

Evan-Daruwalla/claude-skill-suite

Barrido posterior al trabajo realizado por un agente FRESH: ¿el cambio llegó al archivo que se ejecuta? ¿Coinciden las afirmaciones con el disco? ¿Qué debería haberse movido y no lo hizo? ¿Algo privado llegó a una copia pública? Solo se invoca, nunca se activa automáticamente: "landing-check", "did that land", "check my work".

¿Qué es claude-skill-suite?

Este skill, diseñado para agentes como Claude Code, Cursor o Codex, realiza un barrido de verificación posterior al trabajo ejecutado por un agente FRESH. Su objetivo es responder a tres preguntas críticas que ninguna otra herramienta en el flujo de trabajo aborda: ¿el cambio llegó al archivo que realmente se ejecuta? ¿Coinciden las afirmaciones escritas (commits, reportes) con el estado real en disco? ¿Qué debería haberse movido como consecuencia del cambio y no se movió? Está diseñado para detectar una clase de fallo específica observada en la práctica: cambios que aterrizan en archivos muertos (no ejecutados), afirmaciones falsas o imprecisas en reportes y correcciones que no se propagan a todas las copias necesarias. Se invoca manualmente mediante comandos como `/landing-check`, "did that land" o "check my work", ya que su ejecución tiene un costo de agente. El skill se basa en tres pasos: verificar el aterrizaje de cada cambio (archivo modificado vs. archivo ejecutado), re-derivar independientemente cada afirmación del reporte desde el disco y buscar efectos colaterales (copias no actualizadas, fugas de datos privados, obligaciones documentadas incumplidas). Su valor principal es eliminar el punto ciego del desarrollador, quien al resumir su propio trabajo arrastra los mismos sesgos que produjeron el error.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Evan-Daruwalla/claude-skill-suite/tree/HEAD/landing-check

Preguntar en tu IA favorita

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

Documentación

landing-check — ¿el trabajo aterrizó y las afirmaciones son ciertas?

Tres preguntas que nada más en el flujo de herramientas pregunta. /code-review lee el diff para verificar corrección. /audit barre todo el proyecto, en frío. coding-conventions hace que el autor vuelva a ejecutar su propio código. Los tres pueden pasar mientras el cambio fue a un archivo que nada ejecuta, el reporte afirma un número incorrecto y la mitad de las copias nunca fueron tocadas.

La clase de fallo para la que existe esto, observada en la práctica: se desplegó una corrección de seguridad iterando sobre cada archivo .git/hooks/pre-commit en un conjunto de repositorios. Pero varios de esos repositorios tenían configurado core.hooksPath, por lo que git ignora por completo .git/hooks — así que en algunos de ellos la corrección aterrizó en un archivo muerto mientras el hook activo mantenía la ruta antigua. El bucle confirmó cada escritura, y el reporte afirmó que la corrección era universal durante seis días. El diff era correcto. La verificación era real. Ambos trataban sobre el archivo equivocado.

Cada verificación a continuación fue necesaria en una ejecución real. Ninguna es especulativa; consulte la Procedencia al final. Diez ejecuciones después: el barrido ha encontrado cero bugs de código y aproximadamente cuarenta afirmaciones falsas, correcciones mal aterrizadas, guardas muertas y correcciones que no se propagaron. Esa es la naturaleza de lo que detecta.

Activación

/landing-check, o: "did that land", "sweep the changes", "verify what I just did", "check my work before I commit". Solo se invoca — tiene un costo de agente, por lo que nunca se activa por sí solo.

No es este skill

  • Corrección del código en el diff → /code-review (incorporado; tiene multi-agente y --fix). No revise la lógica aquí.
  • Barrido completo del proyecto → /audit (en frío, costoso).
  • Re-ejecutar lo que acabas de escribir → coding-conventions (mismo contexto, ojos del autor, se activa desde el hook PostToolUse). Si un hallazgo pertenece a uno de esos, nómbralo y pásalo — no conviertas este skill en ellos.

Cómo ejecutarlo

Genera UN agente nuevo (herramienta Agent, propósito general). Contexto moderado: esto está limitado a lo que cambió, no al proyecto.

Lo que recibe el agente — solo artefactos:

  • las rutas de repo tocadas y una línea sobre qué es el proyecto;
  • git status + git diff (y git diff --stat por repo) — o, para árboles sin repo, la lista de rutas modificadas en esta sesión;
  • el relato ESCRITO del trabajo: mensajes de commit, la entrada del registro, el texto del reporte final, cualquier documento editado para describir el cambio;
  • cuáles de los árboles tocados son PÚBLICOS (enviados a algún lugar), si los hay;
  • los pasos 1–3 y el formato de salida a continuación, y la instrucción de marcar cualquier cosa que no alcance como NO BARRIDO.

Lo que NO debe recibir: tu relato de lo que hiciste. Las afirmaciones son la muestra. Si le entregas al agente tu resumen, le entregas el mismo punto ciego que produjo el error — te conviertes en acusado y testigo. Él re-deriva cada afirmación a partir de los artefactos escritos y del disco. Esta es la única regla que hace que el skill valga su costo; ignórala y esto es autoevaluación en una segunda ventana.

El agente relee el estado en vivo. git status, adelantado/atrasado, qué está enviado: derivado en el momento del barrido, no de la captura que se le entregó — otras sesiones confirman, envían y editan entre medio (una sesión concurrente ha confirmado una corrección dentro de un commit no relacionado; seis repositorios fueron enviados minutos antes de un barrido al que se le dijo "cero envíos"). ahead N no prueba nada sin un fetch primero — pregunta al remoto (git ls-remote, luego rev-list --left-right --count @{u}...HEAD).

1. ATERRIZAJE — ¿la edición llegó al archivo que se ejecuta?

Para cada archivo modificado, preguntar si existe otra copia y si algo elige entre ellas. La señal es: el archivo editado y el archivo ejecutado tienen el mismo nombre y rutas diferentes.

  • Sombreado: git config core.hooksPath (configurado ⇒ .git/hooks/* es código muerto; resolver con git rev-parse --git-path hooks/<name>, el resolvedor que usa el propio git), orden de PATH para scripts, symlinks, copias vendidas bajo node_modules, una copia de venv vs una copia del repo.
  • Sistemas multi-árbol: si un archivo existe en más de un árbol (instalado / laboratorio / público, dev / dist, src / build), ¿cuál carga el runtime? ¿Se modificó ese?
  • Registro: si el cambio añade o edita algo que debe estar conectado (un hook, una tarea programada, una ruta, un punto de entrada), lee el archivo de registro y confirma que la ruta allí apunta al archivo que modificaste.
  • Activación — el archivo correcto es necesario, no suficiente. Para cualquier cosa que sea un control — una guarda, regla de denegación, matcher de hook, regex, patrón de permisos, aserción canaria, regla de ignorar — planta el positivo que existe para atrapar y observa que se active, luego un negativo y observa que permanezca silencioso. Un control nunca observado activándose es NO VERIFICADO. Controles que se leen como protección y no pudieron activarse, todos encontrados en ejecuciones: reglas de denegación que eran matchers de prefijo y nunca podían bloquear un token en medio de un comando; un regex de fuga cuyo \R compilaba a X:Repo y no podía coincidir con una ruta real; un filtro de nombre que distingue mayúsculas que dejaba pasar una ortografía en mayúsculas; una aserción /findings/.test(src) que era verdadera para siempre.
  • Veredicto por archivo modificado: ATERRIZADO / MAL ATERRIZADO / NO VERIFICABLE (decir por qué). Un archivo cuya copia ejecutable no pudiste determinar es NO VERIFICABLE, no ATERRIZADO. Una copia muerta dejada atrás no es en sí misma un hallazgo — di qué copia está viva y que la edición está en ella.

2. AFIRMACIONES — ¿el relato escrito coincide con el disco?

Extraer cada afirmación verificable de los artefactos, luego re-derivar cada una de forma independiente — un comando diferente al que la produjo, donde exista uno diferente. Orden de prioridad, mayor rendimiento primero:

  1. Universalidades — "todos los 7", "cada copia", "byte-idéntico", "ninguno permanece", "0 hallazgos", "nada se filtró en los 17 repos". Un fallo falsifica toda la declaración, y esta es la clase que produjo el error 08-05. Enumera el conjunto completo y verifica cada miembro; nunca aceptes una verificación puntual como prueba de una universalidad. Una universalidad que solo pudiste verificar puntualmente es NO VERIFICADA.
  2. Conteos — "17 reglas", "29 skills", "21/21". Cuenta desde la fuente de verdad, no desde la oración. Cuidado con el tiempo verbal: un conteo de entradas de registro escritas dentro de la entrada que se está contando está desviado por uno en el momento en que aterriza; una afirmación de "los únicos archivos sucios que quedan" hecha desde dentro de un archivo sucio es auto-falsificante; una cita de una entrada que aún no existe apunta a la nada hasta que se escribe.
  3. Estados — "pasa", "limpio", "regenerado", "enviado". Ejecútalo, o lee el artefacto que lo prueba. La salida citada es una afirmación sobre el programa: si un artefacto cita una línea de salida de una herramienta como evidencia, busca en la herramienta ese texto literal — una línea impresa solo en la rama de fallo no puede evidenciar un pase, y una línea que el programa nunca emite es una cita fabricada.
  4. Números — un valor con más cifras significativas que la salida a la que se remonta está inventado (13 acciones publicadas con 4 decimales a partir de una tabla de 2 decimales: 12 incorrectas). Una estadística de un corpus VIVO (transcripciones, logs, un registro creciente) no es reproducible sin fijar el estado del corpus (conteo de archivos + marca de tiempo); repórtalo como NO VERIFICADO-TAL COMO SE AFIRMA y nombra lo que sí se reproduce. Verifica la aritmética dentro de una oración ("27 más 3 … 29 hoy"). Para comparaciones: mismo conjunto de muestras en todos los brazos, estimador nombrado, n declarado — un 2×2 cuyos brazos no comparten lotes no es una comparación. Un campo ausente no es false. Un == en un flotante que hace un round-trip a través de float32 nunca coincidió, y el JSON confirmado contenía 0.0 para un verdadero 0.605.
  5. Contradicción interna — una oración falsificada por la advertencia de su propio párrafo cinco líneas después; una afirmación y su refutación ambas presentes sin una tachadura fechada; la misma cifra citada tres veces e incorrecta en las tres.

Una afirmación que no puedes verificar se reporta como NO VERIFICADA, nunca como verdadera. Una afirmación que es verdadera pero por una razón diferente a la declarada es un hallazgo.

3. COLATERAL — ¿qué debería haberse movido y no lo hizo?

El diff muestra qué cambió. Esto pregunta qué obligó el cambio y dejó sin hacer. Ejecuta el inverso del diff: por cada valor o concepto cambiado, busca en el árbol otros lugares que aún afirman el antiguo.

  • Copias hermanas — cada otro árbol/rama/paquete que contiene el mismo archivo. La corrección de un mal aterrizaje ha mal aterrizado a su vez en una de dos copias; una copia masiva de un archivo privado sobre su gemelo público ha reintroducido lo que un commit anterior eliminó deliberadamente — compara la copia pública con su propio git show HEAD:, no con la fuente privada.
  • Propagación de corrección — si el trabajo corrige una afirmación, encuentra cada otra copia de la AFIRMACIÓN ANTIGUA: HANDOFF, PRD, bins de memoria, README, comentarios de código, el gemelo público, la propia descripción del skill. "Corregido en el registro, dejó HANDOFF y el bin con los números antiguos" y "la tercera copia de esta afirmación aún no estaba tachada" son los hallazgos más repetidos de cada ejecución.
  • Documentos que citan el valor modificado — READMEs, descripciones de skills, HANDOFF, PRD, comentarios, pines MUST print N/N. Un conteo cambiado en código y sin cambios en prosa es un hallazgo.
  • Fuga de publicación — aterrizó donde NO debe. Si algún árbol tocado es público: barre su diff (y los archivos que tocó, contra HEAD) en busca de identificadores privados — nombres, correos electrónicos, rutas absolutas, nombres de proyectos privados — sin distinción de mayúsculas/minúsculas. Di si este cambio introdujo la cadena o la heredó; las dos necesitan correcciones diferentes y el autor ha llamado a la primera la segunda antes.
  • Gemelos generados — HTML renderizado de un registro, filas de TOC, bins de memoria, anclas: ¿regenerados? Un ancla que resuelve pero aterriza un encabezado antes no está "roto", por lo que broken: 0 no lo prueba.
  • Nuevos tipos de artefacto — ¿el trabajo creó un tipo de archivo que no existía antes (directorios de caché, salida de compilación, logs)? ¿Hay una regla de ignorar, y está en el repo correcto?
  • Subproductos — archivos creados y dejados atrás: archivos sin seguimiento, directorios temporales, __pycache__, .tmp, copias de seguridad. Listarlos con rutas completas; no eliminar nada.
  • La obligación que indican los documentos — si las propias reglas del proyecto dicen que un cambio de este tipo requiere algo (una entrada de registro, un gemelo regenerado, una instantánea sincronizada, una ejecución de prueba, un incremento de pin), verificar que ocurrió.

Sonda — la parte mecánica, ejecutada antes de que el agente juzgue

landing-probe.js (Node portátil, cero dependencias, solo lectura) enumera lo que los pasos 1–3 de otro modo re-derivarían manualmente, para que el agente lea un censo en lugar de adivinar uno. Dale cada árbol tocado; entrega su salida al agente como un artefacto.

node landing-probe.js probe <root>... [--file <p>]... [--since <min>]
                           [--settings <json>] [--remote] [--all]
node landing-probe.js --canary
  • HOOK — por repo, por hook: el archivo que git EJECUTARÁ (git rev-parse --git-path, respeta core.hooksPath) y cualquier copia MUERTA en el otro lugar; una ruta registrada sin archivo es MISSING.
  • CHANGED — staged / modificado / sin seguimiento por repo; --file nombra archivos fuera de cualquier repo; --since N añade archivos modificados en los últimos N minutos bajo raíces SIN repo (un árbol instalado no es un repo).
  • TWIN — por cada archivo modificado, cada archivo con el mismo nombre bajo cualquier raíz, SAME o DIFF (sha256, normalizado CRLF). Nombres convencionales (SKILL.md, README.md — cualquier nombre base con más de 6 copias) coinciden por directorio-padre/nombre, no solo por nombre. --all lista cada grupo gemelo, no solo los modificados.
  • REG — --settings <json>: cada cadena con forma de ruta (después de expansión ~/$HOME/%USERPROFILE%) y si RESUELVE.
  • REMOTE — adelantado/atrasado por repo, etiquetado ref EN CACHÉ a menos que --remote haya obtenido primero. ahead N de una ref en caché no prueba nada.

Salida 1 cuando hay algo que mirar (un hook MUERTO, un gemelo DIFF de un archivo modificado, un registro MISSING); 0 para un censo limpio. No juzga nada — DIFF entre uno privado y su copia pública genericizada es esperado, y el agente lo dice. --canary construye repositorios desechables (hooksPath configurado / no configurado / apuntando a la nada, un remoto vacío y un clon un commit adelante, gemelos CRLF, un bosque de nombres convencionales, un archivo de configuración con una ruta faltante) y DEBE imprimir CANARY PASS 23/23 antes de que confíes en un censo.

Salida

Breve. Esto es un barrido de cordura previo al commit, no un informe de auditoría.

  • Línea de veredicto: SEGURO PARA CONFIRMAR / CORREGIR PRIMERO / NO VERIFICABLE, una oración.
  • Línea de cobertura: qué artefactos se leyeron, qué árboles se barrieron y qué fue NO BARRIDO — un informe breve nunca debe leerse como uno limpio.
  • Tabla de aterrizaje: archivo | copias encontradas | cuál se ejecuta | ¿se activó en un positivo plantado? | veredicto. Solo las filas que son MAL ATERRIZADO o NO VERIFICABLE necesitan detalle.
  • Tabla de afirmaciones: afirmación (citada) | artefacto fuente | resultado re-derivado | VERDADERO / FALSO / NO VERIFICADO.
  • Lista de colaterales: qué debería haberse movido y no lo hizo, cada uno con una ruta.
  • Confirmado: los negativos que soportan carga y los números que se re-derivaron exactamente (sin mal aterrizaje, sin fuga, 25/25 reproducidos) — un barrido que solo reporta fallos no enseña nada sobre lo que es sólido, y el registro del autor los necesita.
  • Traspasos: cualquier cosa perteneciente a /code-review, /audit o coding-conventions, nombrada y pasada en lugar de hecha a medias aquí.

Después del informe

  • Re-verificar cada hallazgo manualmente antes de actuar. Las afirmaciones del verificador son afirmaciones: en una ejecución los enteros re-derivados estaban desviados porque el corpus había crecido debajo de él; los invariantes se mantuvieron. Acepta lo que se reproduce.
  • La corrección está sujeta a las mismas tres preguntas. Las correcciones a hallazgos de CORREGIR PRIMERO van a cada copia y cada documento que cita el valor antiguo — la ejecución que corrigió un mal aterrizaje de una-de-dos-copias envió la corrección a una de dos copias.
  • Escribe la entrada del registro a partir de los valores re-derivados, después de la última ejecución de verificación, no antes: una entrada escrita primero registra el estado que esperabas, y el registro de solo añadidura lo hace permanente.

Reglas

  • Solo hallazgos. No cambiar nada. No arreglar nada. La salida es evidencia; la corrección es responsabilidad del autor.
  • Traspasa lo que no es de este skill. Nombra el skill objetivo y entrega el hallazgo: "El control que nunca se dispara es /audit — no lo barro aquí; lo estoy traspasando."
  • Un punto ciego es un hallazgo. Si no pudiste determinar qué archivo ejecuta un hook, eso es NO VERIFICABLE, no ATERRIZADO. Si una afirmación de universalidad no se pudo enumerar completamente, di qué se perdió — no supongas que el resto es verdadero.
  • Nunca desplazar la fecha o redactar con lenguaje evasivo. "La regla de denegación nunca se activó y no pude probar que coincidiera con una ruta real" no es "la regla de denegación parece no coincidir".

Procedencia

La clase de fallo que se describe aquí se observó primero durante un barrido de seguridad de hooks de git (agosto de 2024, despliegue de seguridad de hooks de 6 repositorios). El bucle que confirmó la corrección verificó cada escritura; el reporte afirmó que la corrección era universal. Pero core.hooksPath dejó varias copias muertas — el cambio aterrizó, la verificación pasó, y el sistema siguió ejecutando la vieja ruta insegura. Esa discrepancia archivo-en-ejecución-vs.-archivo-modificado no es detectable por diferencias, auditoría, ni re-ejecución. Requiere preguntar qué archivo elige el runtime, no si el archivo modificado contiene la corrección correcta.

Después de 10 ejecuciones de producción en enero de 2025, este barrido ha encontrado: 0 bugs de código, ~40 afirmaciones falsas/inexactas, 3 cambios mal aterrizados en archivos que no se estaban ejecutando, 9 correcciones que no se propagaron a todas las copias documentadas, y 2 fugas de datos privados en árboles públicos (nombres de proyecto, rutas absolutas). Ninguno fue detectado por revisión de código o auditoría; todos fueron detectados al hacer las tres preguntas anteriores.

Metadatos (no parte del barrido)

  • Versión del skill: 0.4.1 — expandido para cubrir generación de canarios de sonda, tipos de artefactos nuevos y subproductos, con tres ejecuciones de producción adicionales informando refinamientos.
  • Dependencias: solo lectura; utiliza git y Node.js (a través de landing-probe.js).
  • Cobertura de ejecución: repositorios individuales y multi-árbol; ramas únicas y múltiples; árboles con mezcla de código controlado por versiones e instalado. Archivos no versionados bajo raíces de proyecto (directorios de compilación, salida de generación) se enumeran pero no se verifican a menos que estén referenciados por un registro.
  • Limitación conocida: el barrido no abre hooks que requieren un evento de git (pre-commit, post-checkout) para activarse. Su verificación de activación es sintáctica (el hook es ejecutable y su shebang resuelve) a menos que puedas plantear un positivo en el entorno de ejecución real. Reporta cualquier control no verificado como NO VERIFICADO.

Traducido del skill original en inglés de Evan Daruwalla.

Skills relacionados