Cloudflare publica Security Audit Skill, un agente de IA para auditar código y verificar vulnerabilidades

Cloudflare ha publicado Security Audit Skill, una herramienta para agentes de programación que permite organizar auditorías de seguridad de repositorios mediante varias fases de análisis y validación. El proyecto, disponible en GitHub bajo licencia MIT, coordina agentes independientes para estudiar la arquitectura del software, buscar vulnerabilidades, comprobar los hallazgos y generar informes estructurados. Su objetivo es reducir los falsos positivos y evitar que una sospecha del agente termine presentada como una vulnerabilidad confirmada sin pruebas suficientes.

Las claves de Security Audit Skill en 20 segundos

  • Es una habilidad para agentes de programación que automatiza auditorías de seguridad de repositorios.
  • Divide el análisis en seis fases, desde el reconocimiento hasta la generación de informes.
  • Utiliza agentes independientes para intentar refutar las vulnerabilidades encontradas.
  • Clasifica los resultados como confirmados, pendientes de validación o descartados.
  • Necesita un entorno aislado para ejecutar código, pruebas y procesos potencialmente controlados por el repositorio auditado.

La propuesta parte de una limitación habitual de los asistentes de programación: encontrar una línea sospechosa no demuestra que exista una vulnerabilidad explotable. Un análisis puede detectar una llamada peligrosa o una validación aparentemente insuficiente, pero también puede pasar por alto controles aplicados en otra parte del sistema.

Security Audit Skill intenta resolver ese problema mediante un procedimiento más estricto. En lugar de pedir a un único agente que revise el código y entregue una lista de posibles fallos, organiza distintas tareas, separa a quienes encuentran candidatos de quienes deben verificarlos y conserva evidencias sobre la cobertura del análisis.

El proyecto tiene además una relación directa con el trabajo de investigación de Cloudflare. Según su documentación, esta habilidad fue el punto de partida del sistema de detección de vulnerabilidades que la compañía desarrolló posteriormente para analizar repositorios y ampliar el proceso a escala de flota.

Seis fases para encontrar y comprobar vulnerabilidades

El flujo de trabajo de Security Audit Skill se divide en seis etapas. Cada una tiene una función concreta y genera información que utilizan las siguientes.

La primera es el reconocimiento (reconnaissance). El agente analiza la arquitectura del repositorio, los límites de confianza, las superficies de entrada y las evidencias disponibles. El resultado se recoge en archivos como architecture.md y coverage-ledger.json, que sirven para documentar qué partes del software deben revisarse.

La segunda fase, denominada coverage-led hunting, distribuye el trabajo entre agentes especializados. Cada uno recibe unidades concretas de análisis y registra las comprobaciones realizadas. Otros agentes actúan como revisores de cobertura para detectar zonas que podrían haber quedado sin examinar.

La tercera etapa es la validación de candidatos. Cada posible vulnerabilidad se entrega a un agente distinto del que la encontró. Su cometido consiste en intentar refutarla y comprobar si las evidencias demuestran realmente un fallo.

Esta separación es una de las decisiones más relevantes del diseño. Un agente que acaba de encontrar un problema puede interpretar determinados indicios en favor de su hipótesis. Incorporar otro agente que intente desmontarla introduce una comprobación independiente antes de aceptar el resultado.

La cuarta fase genera los hallazgos en findings.json. El sistema utiliza tres estados:

  • confirmed: vulnerabilidad confirmada, con trazabilidad completa hasta el código y un resultado observado y acotado.
  • needs_validation: existe un indicio fundamentado, pero falta un dato concreto para confirmar el problema.
  • rejected: el candidato ha quedado refutado.

La quinta fase añade una verificación independiente de los registros finales. Otros agentes revisan las afirmaciones sobre el código fuente y, cuando se sustituye un hallazgo por otro de mayor entidad, se solicita una nueva comprobación.

La sexta genera los informes destinados a los equipos técnicos. Entre los archivos previstos figuran REPORT.md, FINDINGS-DETAIL.md y NEEDS-VALIDATION.md, que recogen los resultados confirmados, sus detalles técnicos y los asuntos que todavía requieren investigación.

Menos falsos positivos y más control sobre la cobertura

Uno de los principios del proyecto es que la severidad de un hallazgo debe depender de su impacto y de la probabilidad de explotación, no simplemente de que una implementación se aparte de una lista de buenas prácticas.

La herramienta también distingue entre una vulnerabilidad y una mejora de defensa en profundidad. Si una primera capa de protección bloquea un ataque, la ausencia de una segunda capa no se convierte automáticamente en un fallo de seguridad.

El control de cobertura es otro elemento importante. Security Audit Skill mantiene un registro del trabajo realizado para evitar que una ejecución posterior repita comprobaciones ya cubiertas sin revisar si las evidencias continúan vigentes.

Las sucesivas auditorías pueden aprovechar los resultados anteriores, identificar zonas pendientes y volver a comprobar código que haya cambiado. Sin embargo, el sistema no considera que un análisis antiguo o un resultado todavía sin resolver demuestren que una parte del repositorio está cubierta.

El proyecto incluye validadores independientes para los archivos findings.json y coverage-ledger.json. Estos programas están escritos en JavaScript y no necesitan dependencias externas. Se ejecutan durante el proceso para comprobar que los registros cumplen sus respectivos esquemas y mantienen la estructura esperada.

Cloudflare también incorpora diferentes familias de pruebas para orientar la búsqueda según el tipo de software. Entre ellas figuran seguridad de memoria, sistemas nativos y kernel, inteligencia artificial y modelos de lenguaje, protocolos web, autenticación, aplicaciones cliente, cadena de suministro, infraestructura cloud, mensajería, disponibilidad y aislamiento de datos.

Esta organización permite adaptar la auditoría a la arquitectura del proyecto en lugar de aplicar exactamente la misma lista de comprobaciones a cualquier repositorio.

Instalación con Skills CLI y requisitos de seguridad

Security Audit Skill se instala mediante Skills CLI con este comando:

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-auditLenguaje del código: JavaScript (javascript)

Para instalarla de forma global y disponer de ella a nivel de usuario se puede añadir --global:

npx skills add https://github.com/cloudflare/security-audit-skill \
  --skill security-audit \
  --globalLenguaje del código: PHP (php)

Una vez instalada, basta con iniciar el agente de programación sobre el repositorio que se desea revisar y utilizar instrucciones como:

security audit this codebaseLenguaje del código: JavaScript (javascript)

También admite peticiones más concretas:

find security vulnerabilities in ./src

O indicar una carpeta específica para guardar los informes:

do a security review, output to ~/audits/my-projectLenguaje del código: JavaScript (javascript)

Cuando se solicita una auditoría completa, la habilidad utiliza el flujo de seis fases. Si no se especifica una ubicación para los resultados, emplea por defecto una carpeta bajo ~/security-audit-skill/, organizada por repositorio y número de ejecución.

Los requisitos técnicos incluyen un agente de programación compatible con herramientas y subagentes en paralelo, Node.js para ejecutar los validadores y un entorno aislado para las operaciones que puedan ejecutar código del repositorio.

Este último requisito es especialmente importante. Cloudflare pide un sandbox que desactive la conectividad externa, utilice variables de entorno depuradas y permitidas, limite los recursos disponibles y restrinja las escrituras a directorios temporales asignados. Sin esas protecciones, el sistema mantiene los hallazgos afectados como pendientes de validación en lugar de ejecutar código potencialmente controlado por el objetivo.

Esta precaución evita que una auditoría de seguridad termine ejecutando procesos, compilaciones o pruebas en un entorno con acceso innecesario a sistemas externos o información sensible.

Security Audit Skill puede resultar útil para equipos de desarrollo que ya utilizan agentes de programación y quieren incorporar revisiones de seguridad más estructuradas a su trabajo. Su principal aportación está en separar la búsqueda de vulnerabilidades de su verificación y mantener un registro verificable de lo que se ha analizado. No sustituye una auditoría profesional ni garantiza que se detecten todos los fallos, pero proporciona una metodología reproducible para que los agentes investiguen el código con más rigor.

Preguntas frecuentes

¿Qué es Cloudflare Security Audit Skill?

Es una habilidad para agentes de programación que organiza auditorías de seguridad de repositorios mediante seis fases de reconocimiento, búsqueda, validación y elaboración de informes.

¿Qué agentes de inteligencia artificial necesita?

Requiere un agente de programación que admita uso de herramientas y ejecución de subagentes en paralelo. La documentación facilitada no establece una lista cerrada de modelos compatibles.

¿Cómo se instala Security Audit Skill?

Se instala con Skills CLI mediante npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit. También permite una instalación global con --global.

¿Security Audit Skill garantiza que las vulnerabilidades sean reales?

No garantiza una detección completa, pero incorpora agentes verificadores independientes y tres estados para distinguir vulnerabilidades confirmadas, candidatos pendientes y resultados descartados.

Suscríbete al boletín SysAdmin

Este es tu recurso para las últimas noticias y consejos sobre administración de sistemas, Linux, Windows, cloud computing, seguridad de la nube, etc. Lo enviamos 2 días a la semana. Recuerda revisar tu email para confirmar la suscripción.

Scroll al inicio
×