PR Reviewer Skill para OpenClaw

OpenClaw PR Reviewer Skill — Descripción General

El skill PR Reviewer convierte a OpenClaw en un asistente automatizado de revisión de código para tus Pull Requests. En lugar de esperar horas a que un compañero revise tu PR, puedes obtener feedback inmediato impulsado por IA sobre calidad de código, bugs potenciales, problemas de seguridad y consistencia de estilo.

Este skill lee los diffs de Pull Request y proporciona feedback estructurado y accionable — similar a lo que un desarrollador senior señalaría durante una revisión de código. Opera en modo solo lectura por defecto, lo que significa que solo comenta y sugiere; nunca fusiona, aprueba o modifica código sin tu instrucción explícita.

El skill OpenClaw PR Reviewer está diseñado para complementar a los revisores humanos, no reemplazarlos. Captura los problemas mecánicos (errores tipográficos, imports no utilizados, manejo de errores faltante) para que tu equipo pueda enfocarse en la arquitectura, lógica y decisiones de diseño.

Flujo de trabajo típico:

1. Abre un Pull Request en GitHub.
2. Pide a OpenClaw que revise el PR.
3. El agente obtiene el diff, analiza cada archivo modificado y devuelve una revisión estructurada con sugerencias en línea — lista para que actúes.

Requisitos Previos para el PR Reviewer Skill

Antes de instalar el skill PR Reviewer, asegúrate de tener:

• OpenClaw instalado y ejecutándose (v1.0+)
• GitHub CLI (gh) instalado y autenticado — guía de instalación
• Acceso al repositorio que contiene el Pull Request
• clawhub CLI instalado para gestión de skills

Verifica tu configuración:

# Verificar versión de OpenClaw
openclaw --version

# Verificar versión de GitHub CLI
gh --version

# Verificar autenticación de GitHub
gh auth status

El skill PR Reviewer funciona mejor combinado con el skill GitHub, que proporciona el acceso subyacente a la API de GitHub.

Cómo Instalar el PR Reviewer Skill

Instala el skill PR Reviewer con un solo comando:

npx clawhub@latest install pr-reviewer

Para verificar la instalación:

clawhub list

Deberías ver pr-reviewer en la lista de skills instalados. El skill está listo para usar inmediatamente después de la instalación.

Configuración del PR Reviewer Skill

El skill PR Reviewer funciona directamente con configuraciones predeterminadas sensatas. Utiliza tu autenticación GitHub existente (vía gh auth) para acceder a los datos de Pull Request.

Alcance de Revisión

Por defecto, el skill revisa:

| Aspecto | Qué Verifica | |---------|-------------| | Calidad de código | Variables no utilizadas, código muerto, complejidad innecesaria | | Detección de bugs | Riesgos de puntero nulo, errores off-by-one, condiciones de carrera | | Seguridad | Secretos hardcodeados, inyección SQL, vulnerabilidades XSS | | Estilo | Convenciones de nomenclatura, inconsistencias de formato | | Testing | Cobertura de tests faltante para nueva lógica | | Documentación | Comentarios desactualizados, JSDoc/docstrings faltantes |

Configuración del Entorno

# Asegurar que GitHub CLI está autenticado
gh auth login

# O configurar un Token de Acceso Personal con scope repo
export GITHUB_TOKEN=ghp_your_token_here

Importante: El skill PR Reviewer solo necesita acceso de lectura al contenido del repositorio y Pull Requests. No otorgues scopes de escritura o administrador a menos que explícitamente quieras que el agente publique comentarios en tu nombre.

Ejemplos de Uso del PR Reviewer Skill

1. Revisar un Pull Request Específico

Tú: "Revisa el PR #42 en nuestro repo principal."

El agente obtiene el diff del PR #42 usando gh pr diff 42, luego analiza cada archivo modificado y devuelve una revisión estructurada:

• Resumen: 3 archivos modificados, 127 líneas añadidas, 45 eliminadas. Añade un nuevo módulo de procesamiento de pagos.
• Problemas encontrados: 2 bugs, 1 preocupación de seguridad, 3 sugerencias de estilo.
• Cada problema incluye nombre del archivo, número de línea, severidad y una corrección recomendada.

2. Enfocarse Solo en Problemas de Seguridad

Tú: "Verifica el PR #128 en busca de vulnerabilidades de seguridad."

El agente realiza una revisión enfocada en seguridad, escaneando:

• Claves API o secretos hardcodeados
• Patrones de inyección SQL o NoSQL
• Vectores de Cross-Site Scripting (XSS)
• Deserialización insegura
• Validación de entrada faltante

Devuelve solo hallazgos relevantes de seguridad, con referencias OWASP cuando sea aplicable.

3. Resumir Cambios de un PR Grande

Tú: "Dame un resumen de los cambios en el PR #256. Es uno grande."

El agente lee todo el diff y produce un resumen conciso:

• Descripción de alto nivel de lo que logra el PR
• Lista de archivos modificados, agrupados por módulo o funcionalidad
• Decisiones arquitectónicas clave o trade-offs
• Riesgos potenciales o áreas que necesitan atención extra durante la revisión humana

4. Comparar con Estándares de Codificación

Tú: "Revisa el PR #99 según los estándares de codificación TypeScript de nuestro equipo."

El agente aplica las convenciones de tu equipo a la revisión, verificando:

• Uso consistente de interface vs type
• Patrones apropiados de manejo de errores
• Orden de imports y barrel exports
• Convenciones de nomenclatura de componentes (PascalCase para componentes React)

Seguridad y Mejores Prácticas

El skill PR Reviewer es solo lectura por defecto — obtiene diffs y genera feedback pero no publica comentarios, aprueba PRs o fusiona código a menos que se instruya explícitamente.

Sigue estas directrices para mantenerte seguro:

• Mantenlo en solo lectura. La configuración predeterminada solo lee datos de PR. Si habilitas la publicación de comentarios, revisa cada comentario antes de que se publique.
• Usa privilegio mínimo. Otorga solo scope repo:read si usas un PAT. El skill no necesita acceso de escritura para su funcionalidad principal de revisión.
• Revisa la revisión. El feedback generado por IA no es infalible. Siempre aplica tu propio juicio antes de actuar sobre las sugerencias, especialmente para código sensible a la seguridad.
• No saltes la revisión humana. Este skill acelera el proceso de revisión pero no debería ser el único revisor. Úsalo como una primera pasada para capturar problemas mecánicos.
• Protege repos sensibles. Para repositorios que contienen algoritmos propietarios o secretos comerciales, asegúrate de que las políticas de tu organización permitan revisión de código asistida por IA.

Solución de Errores Comunes

"Could not fetch PR diff"

El GitHub CLI no puede acceder al Pull Request. Causas comunes:

# Re-autenticarse con GitHub
gh auth login

# Verificar acceso al repositorio
gh repo view owner/repo

# Verificar que el número de PR existe
gh pr view 42

"PR diff is too large to analyze"

PRs muy grandes (1000+ líneas cambiadas) pueden alcanzar límites de contexto. Intenta:

Tú: "Revisa solo los cambios de src/api/ en el PR #200."

Reducir el alcance a directorios o archivos específicos ayuda al agente a proporcionar feedback más enfocado y de mayor calidad.

"No issues found"

Puede significar que el código está limpio o que el diff es demasiado pequeño para feedback significativo. El agente aún proporcionará un resumen de cambios incluso cuando no se detecten problemas.