code-review-playbook
Estandarizar las revisiones de código
Las revisiones inconsistentes ralentizan a los equipos y hacen que los comentarios sean más difíciles de aplicar. Esta skill proporciona listas de verificación, formatos de comentarios y plantillas para flujos de revisión claros.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Recursos legibles por agentes
Usa estos enlaces cuando un AI Agent, crawler o script necesite contexto limpio en lugar de leer toda la página.
Pruébalo
Usando "code-review-playbook". Revisa un PR que agrega lógica de reintento de pagos y nuevas pruebas.
Resultado esperado:
- Resumen del cambio y decisión de revisión.
- Problemas bloqueantes agrupados por gravedad y ubicación de archivo.
- Sugerencias no bloqueantes con justificación clara.
- Brechas de pruebas y acciones de seguimiento.
Usando "code-review-playbook". Ayuda a escribir una descripción de PR para un nuevo endpoint de API.
Resultado esperado:
- Descripción concisa de qué cambió y por qué.
- Instrucciones de prueba para revisores.
- Elementos de lista de verificación de seguridad, base de datos y compatibilidad.
- Notas de riesgo y consideraciones de rollback.
Usando "code-review-playbook". Convierte notas informales de revisión en comentarios convencionales.
Resultado esperado:
- Comentarios etiquetados como issue, suggestion, question, nitpick, praise o security.
- El estado bloqueante se explicita donde sea necesario.
- Cada comentario explica el impacto y la acción recomendada.
Auditoría de seguridad
Riesgo medioStatic command, crypto, reconnaissance, and network flags were reviewed as Markdown examples, checklist labels, or documentation links rather than executable behavior. No malicious intent, prompt-injection text, credential exfiltration, or runnable command execution was found. The main concern is that copyable LLM review automation examples interpolate untrusted diffs and code into prompts without prompt-injection guidance.
Problemas de riesgo medio (1)
Problemas de riesgo bajo (3)
Puntuación de calidad
Lo que puedes crear
Revisar pull requests de forma consistente
Usa la lista de verificación y las etiquetas de comentarios para revisar cambios con gravedad clara y feedback accionable.
Preparar cambios antes de la revisión
Ejecuta una autoevaluación con la plantilla de pull request antes de pedir feedback a tus compañeros de equipo.
Definir estándares de revisión del equipo
Adopta las plantillas y la guía de proceso como base para las normas de revisión del equipo.
Prueba estos prompts
Usa code-review-playbook para revisar este pull request pequeño. Enfócate en la corrección, las pruebas y comentarios convencionales claros.
Usa la plantilla de pull request de code-review-playbook para ayudarme a preparar una descripción completa del PR y notas de pruebas.
Usa los patrones de feedback de revisión para clasificar estos comentarios como bloqueantes, no bloqueantes, preguntas o detalles menores.
Usa code-review-playbook para crear una política de revisión de equipo con etiquetas de gravedad, expectativas para revisores y criterios de merge.
Mejores prácticas
- Revisa la descripción del pull request y las pruebas antes de leer los cambios línea por línea.
- Usa etiquetas convencionales para aclarar la gravedad y el impacto en el merge.
- Separa los defectos que deben corregirse de las preferencias y mejoras de seguimiento.
Evitar
- Bloquear un merge por preferencias subjetivas de estilo que la automatización puede gestionar.
- Dejar feedback vago sin explicar el impacto o una posible solución.
- Aprobar cambios grandes o riesgosos sin verificar pruebas, seguridad e impacto del despliegue.