seguridad-escanear

Skill de Escaneo de Seguridad

Audita tu configuración de Claude Code en busca de problemas de seguridad usando AgentShield.

Cuándo Activarlo

• Al configurar un nuevo proyecto de Claude Code
• Después de modificar .claude/settings.json, CLAUDE.md o configuraciones MCP
• Antes de confirmar cambios de configuración
• Al incorporarte a un repositorio existente con configuraciones de Claude Code
• Revisiones periódicas de higiene de seguridad

Qué Escanea

Archivo	Comprobaciones
CLAUDE.md	Secretos codificados, instrucciones de ejecución automática, patrones de inyección de prompt
settings.json	Listas de permitidos demasiado permisivas, listas de denegados faltantes, banderas de omisión peligrosas
mcp.json	Servidores MCP riesgosos, secretos de entorno codificados, riesgos de cadena de suministro de npx
hooks/	Inyección de comandos mediante interpolación, exfiltración de datos, supresión silenciosa de errores
agents/*.md	Acceso sin restricciones a herramientas, superficie de inyección de prompt, especificaciones de modelo faltantes

Prerrequisitos

AgentShield debe estar instalado. Verifica e instala si es necesario:

# Verificar si está instalado
npx ecc-agentshield --version

# Instalar globalmente (recomendado)
npm install -g ecc-agentshield

# O ejecutar directamente con npx (sin necesidad de instalar)
npx ecc-agentshield scan .

Uso

Escaneo Básico

Ejecuta contra el directorio .claude/ del proyecto actual:

# Escanear proyecto actual
npx ecc-agentshield scan

# Escanear una ruta específica
npx ecc-agentshield scan --path /ruta/a/.claude

# Escanear con filtro de severidad mínima
npx ecc-agentshield scan --min-severity medium

Formatos de Salida

# Salida en terminal (predeterminada) — informe coloreado con calificación
npx ecc-agentshield scan

# JSON — para integración CI/CD
npx ecc-agentshield scan --format json

# Markdown — para documentación
npx ecc-agentshield scan --format markdown

# HTML — informe autónomo con tema oscuro
npx ecc-agentshield scan --format html > informe-seguridad.html

Corrección Automática

Aplica correcciones seguras automáticamente (solo las marcadas como auto-corregibles):

npx ecc-agentshield scan --fix

Esto:

• Reemplazará secretos codificados con referencias a variables de entorno
• Ajustará permisos comodín a alternativas con alcance limitado
• Nunca modificará sugerencias solo manuales

Análisis Profundo con Opus 4.6

Ejecuta el pipeline adversarial de tres agentes para un análisis más profundo:

# Requiere ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=tu-clave
npx ecc-agentshield scan --opus --stream

Esto ejecuta:

1. Atacante (Equipo Rojo) — encuentra vectores de ataque
2. Defensor (Equipo Azul) — recomienda endurecimiento
3. Auditor (Veredicto Final) — sintetiza ambas perspectivas

Inicializar Configuración Segura

Crea una nueva configuración segura .claude/ desde cero:

npx ecc-agentshield init

Crea:

• settings.json con permisos con alcance limitado y lista de denegados
• CLAUDE.md con mejores prácticas de seguridad
• mcp.json como marcador de posición

Acción de GitHub

Agrega a tu pipeline CI:

- uses: affaan-m/agentshield@v1
  with:
    path: '.'
    min-severity: 'medium'
    fail-on-findings: true

Niveles de Severidad

Calificación	Puntaje	Significado
A	90-100	Configuración segura
B	75-89	Problemas menores
C	60-74	Requiere atención
D	40-59	Riesgos significativos
F	0-39	Vulnerabilidades críticas

Interpretación de Resultados

Hallazgos Críticos (corregir inmediatamente)

• Claves API o tokens codificados en archivos de configuración
• Bash(*) en la lista de permitidos (acceso sin restricciones a shell)
• Inyección de comandos en hooks mediante interpolación ${file}
• Servidores MCP que ejecutan shell

Hallazgos Altos (corregir antes de producción)

• Instrucciones de ejecución automática en CLAUDE.md (vector de inyección de prompt)
• Listas de denegados faltantes en permisos
• Agentes con acceso innecesario a Bash

Hallazgos Medios (recomendado)

• Supresión silenciosa de errores en hooks (2>/dev/null, || true)
• Hooks de seguridad PreToolUse faltantes
• Instalación automática npx -y en configuraciones de servidores MCP

Hallazgos Informativos (concientización)

• Descripciones faltantes en servidores MCP
• Instrucciones prohibitivas correctamente señaladas como buena práctica

Enlaces

• GitHub: github.com/affaan-m/agentshield
• npm: npmjs.com/package/ecc-agentshield