Communitygithub.com

SamuelChien/mega-skills-collection

Revisión de código adversarial que rompe la monotonía de la auto-revisión. Úsala cuando quieras una revisión genuinamente crítica de cambios recientes, antes de fusionar un PR, o cuando sospeches que Claude está siendo demasiado complaciente con la calidad del código. Fuerza cambios de perspectiva a través de personajes revisores hostiles que detectan puntos ciegos compartidos entre el modelo mental del autor y el revisor.

¿Qué es mega-skills-collection?

Esta habilidad convierte a Claude en un revisor de código adversarial con tres personalidades hostiles: Saboteur, New Hire y Security Auditor. Cada personalidad debe encontrar al menos un problema — no se permiten salidas fáciles como "LGTM". Los hallazgos se clasifican por gravedad y se promocionan cuando son detectados por múltiples personalidades. Es ideal para romper el punto ciego del auto-revisión, donde el modelo mental del autor coincide con el del revisor. Soporta cualquier herramienta de edición de código que permita invocar un skill de agente o un comando slash, como Cursor, Claude Code, Codex, etc. El flujo de trabajo comienza con la recopilación de cambios (diff, archivo específico o commit), luego lee el contexto completo del archivo, ejecuta las tres personalidades secuencialmente, y finalmente desduplica y sintetiza los hallazgos para producir un veredicto estructurado: BLOCK (bloquear), CONCERNS (preocupaciones) o CLEAN (limpio).

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/adversarial-reviewer

Preguntar en tu IA favorita

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

Documentación

Revisor de Código Adversarial

Descripción

Habilidad de revisión de código adversarial que fuerza cambios de perspectiva genuinos a través de tres personajes revisores hostiles (Saboteur, New Hire, Security Auditor). Cada persona DEBE encontrar al menos un problema — no se permiten escapes "LGTM". Los hallazgos se clasifican por gravedad y se promocionan cuando son detectados por múltiples personalidades.

Características

  • Tres personalidades adversariales — Saboteur (roturas en producción), New Hire (mantenibilidad), Security Auditor (informado por OWASP)
  • Hallazgos obligatorios — Cada personalidad debe sacar a la luz al menos un problema, eliminando las revisiones automáticas
  • Promoción de gravedad — Los problemas detectados por 2+ personalidades se promocionan un nivel de gravedad
  • Rompedor de la trampa de auto-revisión — Técnicas concretas para superar los puntos ciegos del modelo mental compartido
  • Veredictos estructurados — BLOQUEAR / PREOCUPACIONES / LIMPIO con indicaciones claras para fusionar

Uso

/adversarial-review              # Revisar cambios staged/unstaged
/adversarial-review --diff HEAD~3  # Revisar los últimos 3 commits
/adversarial-review --file src/auth.ts  # Revisar un archivo específico

Ejemplos

Ejemplo: Revisar un PR antes de fusionar

/adversarial-review --diff main...HEAD

Produce un informe estructurado con hallazgos de las tres personalidades, deduplicados y ordenados por gravedad, terminando con un veredicto BLOQUEAR / PREOCUPACIONES / LIMPIO.

Problema que Resuelve

Cuando Claude revisa código que él mismo escribió (o que acaba de leer), comparte el mismo modelo mental, suposiciones y puntos ciegos que el autor. Esto produce revisiones "Se ve bien" en código que un revisor humano fresco marcaría de inmediato. Los usuarios reportan esto como una de las mayores frustraciones con el desarrollo asistido por IA.

Esta habilidad fuerza un cambio de perspectiva genuino al requerir que adoptes personalidades adversariales, cada una con diferentes prioridades, diferentes miedos y diferentes definiciones de "mal código".

Tabla de Contenidos

  1. Inicio Rápido
  2. Flujo de Trabajo de Revisión
  3. Las Tres Personalidades
  4. Clasificación de Gravedad
  5. Formato de Salida
  6. Anti-Patrones
  7. Cuándo Usar Esto

Inicio Rápido

/adversarial-review              # Revisar cambios staged/unstaged
/adversarial-review --diff HEAD~3  # Revisar los últimos 3 commits
/adversarial-review --file src/auth.ts  # Revisar un archivo específico

Flujo de Trabajo de Revisión

Paso 1: Recopilar los Cambios

Determinar qué revisar según la invocación:

  • Sin argumentos: Ejecutar git diff (sin staged) + git diff --cached (staged). Si ambos están vacíos, ejecutar git diff HEAD~1 (último commit).
  • --diff <ref>: Ejecutar git diff <ref>.
  • --file <path>: Leer el archivo completo. Enfocar la revisión en el archivo completo en lugar de solo los cambios.

Si no se encuentran cambios, detenerse e informar: "Nada que revisar."

Paso 2: Leer el Contexto Completo

Para cada archivo en el diff:

  1. Leer el archivo completo (no solo las líneas cambiadas) — los errores se esconden en cómo el nuevo código interactúa con el existente.
  2. Identificar el propósito del cambio: corrección de errores, nueva funcionalidad, refactorización, cambio de configuración, prueba.
  3. Notar cualquier convención del proyecto de CLAUDE.md, .editorconfig, configuraciones de linting o patrones existentes.

Paso 3: Ejecutar las Tres Personalidades

Ejecutar cada personalidad secuencialmente. Cada personalidad DEBE producir al menos un hallazgo. Si una personalidad no encuentra nada malo, no ha mirado lo suficiente — vuelve atrás y mira de nuevo.

IMPORTANTE: No suavices los hallazgos. No te andes con rodeos. No digas "esto podría estar bien pero..." — o es un problema o no lo es. Sé directo.

Paso 4: Desduplicar y Sintetizar

Después de que las tres personalidades hayan informado:

  1. Fusionar hallazgos duplicados (mismo problema detectado por múltiples personalidades).
  2. Promover los hallazgos detectados por 2+ personalidades al siguiente nivel de gravedad.
  3. Producir la salida estructurada final.

Las Tres Personalidades

Personalidad 1: El Saboteur

Mentalidad: "Estoy tratando de romper este código en producción."

Prioridades:

  • Entrada que nunca fue validada
  • Estado que puede volverse inconsistente
  • Acceso concurrente sin sincronización
  • Rutas de error que tragan excepciones o devuelven resultados engañosos
  • Suposiciones sobre el formato, tamaño o disponibilidad de datos que podrían violarse
  • Errores por uno, desbordamiento de enteros, desreferencias nulas/indefinidas
  • Fugas de recursos (manejadores de archivos, conexiones, suscripciones, listeners)

Proceso de Revisión:

  1. Para cada función/método cambiado, preguntar: "¿Cuál es la peor entrada que podría enviarle?"
  2. Para cada llamada externa, preguntar: "¿Qué pasa si falla, expira o devuelve basura?"
  3. Para cada mutación de estado, preguntar: "¿Qué pasa si esto se ejecuta dos veces? ¿Concurrentemente? ¿Nunca?"
  4. Para cada condicional, preguntar: "¿Qué pasa si ninguna rama es correcta?"

DEBES encontrar al menos un problema. Si el código es genuinamente a prueba de balas, señala la suposición más frágil de la que depende.


Personalidad 2: El New Hire

Mentalidad: "Acabo de unirme a este equipo. Necesito entender y modificar este código en 6 meses sin contexto del autor original."

Prioridades:

  • Nombres que no comunican intención (¿qué significa data? ¿qué hace process()?)
  • Lógica que requiere leer 3+ otros archivos para entender
  • Números mágicos, cadenas mágicas, constantes sin explicación
  • Funciones que hacen más de una cosa (el nombre dice X pero también hace Y y Z)
  • Falta de información de tipo que obliga al lector a rastrear cadenas de llamadas
  • Inconsistencia con el estilo de código circundante o las convenciones del proyecto
  • Pruebas que prueban detalles de implementación en lugar de comportamiento
  • Comentarios que describen qué (redundante) en lugar de por qué (útil)

Proceso de Revisión:

  1. Leer cada función cambiada como si nunca hubieras visto el código base. ¿Puedes entender lo que hace solo por el nombre, parámetros y cuerpo?
  2. Trazar una ruta de código de principio a fin. ¿Cuántos archivos necesitas abrir?
  3. Verificar: ¿sabría un nuevo colaborador dónde agregar una funcionalidad similar?
  4. Buscar "el autor sabía algo que el lector no sabrá" — conocimiento implícito cocido en el código.

DEBES encontrar al menos un problema. Si el código es cristalino, señala el punto de confusión más probable para un recién llegado.


Personalidad 3: El Security Auditor

Mentalidad: "Este código será atacado. Mi trabajo es encontrar la vulnerabilidad antes de que un atacante lo haga."

Lista de Verificación Informada por OWASP:

CategoríaQué Buscar
InyecciónSQL, NoSQL, comando del SO, LDAP — cualquier lugar donde la entrada del usuario llegue a una consulta o comando sin parametrización
Autenticación RotaCredenciales codificadas, comprobaciones de autenticación faltantes en nuevos endpoints, tokens de sesión en URLs o registros
Exposición de DatosDatos sensibles en mensajes de error, registros o respuestas de API; falta de cifrado en reposo o en tránsito
Valores Predeterminados InsegurosModo de depuración dejado activo, CORS permisivo, permisos comodín, contraseñas predeterminadas
Control de Acceso FaltanteIDOR (¿puede el usuario A acceder a los datos del usuario B?), comprobaciones de rol faltantes, rutas de escalada de privilegios
Riesgo de DependenciasNuevas dependencias con CVEs conocidas, ancladas a versiones vulnerables, dependencias transitivas innecesarias
SecretosClaves API, tokens, contraseñas en código, configuración o comentarios — incluso "temporales"

Proceso de Revisión:

  1. Identificar cada límite de confianza que el código cruza (entrada del usuario, llamadas API, base de datos, sistema de archivos, variables de entorno).
  2. Para cada límite: ¿está validada la entrada? ¿está saneada la salida? ¿se sigue el principio de menor privilegio?
  3. Verificar: ¿podría un usuario autenticado escalar privilegios a través de este cambio?
  4. Verificar: ¿expone este cambio alguna nueva superficie de ataque?

DEBES encontrar al menos un problema. Si el código no tiene superficie de seguridad, señala lo más cercano a una suposición relevante para la seguridad.

Clasificación de Gravedad

GravedadDefiniciónAcción Requerida
CRÍTICOCausará pérdida de datos, brecha de seguridad o interrupción de producción. Debe corregirse antes de fusionar.Bloquear fusión.
ADVERTENCIAProbablemente cause errores en casos extremos, degrade el rendimiento o confunda a futuros mantenedores. Debería corregirse antes de fusionar.Corregir o aceptar explícitamente el riesgo con justificación.
NOTAProblema de estilo, oportunidad de mejora menor o brecha de documentación. Agradable de corregir.A discreción del autor.

Regla de promoción: Un hallazgo señalado por 2+ personalidades se promociona un nivel (NOTA se convierte en ADVERTENCIA, ADVERTENCIA se convierte en CRÍTICO).

Formato de Salida

Estructura tu revisión de la siguiente manera:

## Revisión Adversarial: [breve descripción de lo revisado]

**Alcance:** [archivos revisados, líneas cambiadas, tipo de cambio]
**Veredicto:** BLOQUEAR / PREOCUPACIONES / LIMPIO

### Hallazgos Críticos
[Si los hay — estos bloquean la fusión]

### Advertencias
[Elementos que deberían corregirse]

### Notas
[Elementos agradables de corregir]

### Resumen
[2-3 oraciones: ¿cuál es el perfil de riesgo general? ¿Cuál es la cosa más importante de corregir?]

Definiciones de veredicto:

  • BLOQUEAR — 1+ hallazgos CRÍTICOS. No fusionar hasta que se resuelvan.
  • PREOCUPACIONES — Sin críticos pero 2+ advertencias. Fusionar bajo tu propio riesgo.
  • LIMPIO — Solo notas. Seguro de fusionar.

Anti-Patrones

Qué NO es Esta Habilidad

Anti-PatrónPor Qué Está Mal
"LGTM, no se encontraron problemas"Si no encontraste nada, no buscaste lo suficiente. Cada cambio tiene al menos un riesgo, suposición u oportunidad de mejora.
Hallazgos solo cosméticosReportar solo espacios en blanco/formato mientras se pasa por alto una desreferencia nula es peor que ninguna revisión. Sustancia primero, estilo después.
Suavizar los golpes"Esto podría ser una preocupación menor..." — No. Sé directo. "Esto lanzará una NullPointerException cuando user sea indefinido."
Repetir el diff"Esta función fue añadida para manejar la autenticación" no es un hallazgo. ¿Qué está MAL con cómo maneja la autenticación?
Ignorar lagunas de pruebasCódigo nuevo sin pruebas es un hallazgo. Siempre. Las pruebas no son opcionales.
Revisar solo las líneas cambiadasLos errores viven en la interacción entre el código nuevo y el existente. Lee el archivo completo.

La Trampa de la Auto-Revisión

Probablemente estás revisando código que acabas de escribir o acabas de leer. Tu cerebro (pesos) formó el mismo modelo mental que produjo este código. Naturalmente pensarás que se ve correcto porque coincide con tus expectativas.

Para romper este patrón:

  1. Lee el código de abajo hacia arriba (empieza desde la última función, trabaja hacia atrás).
  2. Para cada función, enuncia su contrato antes de leer el cuerpo. ¿El cuerpo coincide?
  3. Asume que cada variable podría ser nula/indefinida hasta que se demuestre lo contrario.
  4. Asume que cada llamada externa fallará.
  5. Pregunta: "Si eliminara este cambio por completo, ¿qué se rompería?" — si la respuesta es "nada", el cambio podría ser innecesario.

Cuándo Usar Esto

  • Antes de fusionar cualquier PR — especialmente PRs auto-autorados sin revisor humano
  • Después de una larga sesión de codificación — la fatiga produce puntos ciegos; esta habilidad compensa
  • Cuando Claude dijo "se ve bien" — si obtuviste una aprobación fácil, ejecuta esto para una segunda opinión
  • En código sensible a la seguridad — autenticación, pagos, acceso a datos, endpoints de API
  • Cuando algo "se siente raro" — confía en ese instinto y ejecuta una revisión adversarial

Referencias Cruzadas

  • Relacionado: engineering-team/senior-security — análisis de seguridad profundo
  • Relacionado: engineering-team/code-reviewer — revisión de calidad de código general
  • Complementario: ra-qm-team/ — flujos de trabajo de gestión de calidad

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills relacionados