code-review-excellence
Dominar las Mejores Prácticas de Revisión de Código
Las revisiones de código a menudo se convierten en cuellos de botella o fuentes de fricción en el equipo. Esta habilidad proporciona técnicas estructuradas para dar retroalimentación constructiva, realizar revisiones exhaustivas y convertir cada revisión en una oportunidad de compartir conocimientos que mejora la calidad del código y la colaboración del equipo.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Pruébalo
Usando "code-review-excellence". How should I give feedback on this code that has a security vulnerability?
Resultado esperado:
Frame your feedback using the context-issue-solution pattern:
[Context] I noticed the payment processing logic is in the controller.
[Specific Issue] The calculateTotal() function uses string concatenation for SQL queries, which is vulnerable to injection.
[Helpful Solution] Consider using parameterized queries instead. Here's an example pattern...
Usando "code-review-excellence". What are the key things to check when reviewing a pull request?
Resultado esperado:
Use the 4-phase review process:
1. Context Gathering: PR description, CI status, business requirements
2. High-Level Review: Architecture, design, file organization, testing strategy
3. Line-by-Line Review: Logic correctness, security, performance, maintainability
4. Summary: Clear decision with prioritized feedback
Auditoría de seguridad
Riesgo bajoStatic analysis detected patterns in documentation that appear concerning but are false positives. The skill is a code review guide containing examples of vulnerabilities and code patterns for educational purposes. All detected patterns (eval references, backticks, URLs, fetch calls) are documentation content, not executable code. No actual security risks found. Safe to publish.
Factores de riesgo
⚡ Contiene scripts
🌐 Acceso a red
⚙️ Comandos externos
Puntuación de calidad
Lo que puedes crear
Aprendiendo Revisiones de Código Efectivas
Nuevos desarrolladores o miembros del equipo que aprenden a realizar revisiones de código constructivas que mejoran la calidad del código mientras mantienen dinámicas positivas en el equipo.
Mejorando Procesos de Revisión
Equipos que desean establecer o mejorar sus prácticas de revisión de código con enfoques sistemáticos, listas de verificación y marcos de retroalimentación.
Asistencia en Revisión de Código
Al preparar o realizar revisiones de código, usa esta habilidad para estructurar la retroalimentación, priorizar problemas y garantizar una cobertura integral.
Prueba estos prompts
Help me review this pull request. I want to: 1) Understand the overall approach and architecture, 2) Check for security issues, 3) Look for performance problems, 4) Ensure the code is maintainable. What should I focus on and what questions should I ask the author?
Review this code specifically for security issues. Check for: input validation, SQL injection risks, XSS vulnerabilities, authentication gaps, hardcoded secrets, and proper error handling. What security concerns should I raise?
Review this Python code for Python-specific issues like mutable default arguments, bare except clauses, correct exception handling, and Pythonic patterns. What improvements would you suggest?
I found several issues in this code. Help me construct feedback that is: specific and actionable, educational rather than judgmental, balanced with praise for what was done well, and clearly prioritized by severity.
Mejores prácticas
- Revisa el código rápidamente dentro de las 24 horas para mantener la velocidad del equipo y mostrar respeto por el trabajo del autor
- Usa el método sándwich modificado: contexto primero, luego el problema específico, luego una solución útil
- Diferencia claramente la gravedad con etiquetas como [bloqueante], [importante], [nit] y [elogio]
Evitar
- Criticar problemas de formato que deberían ser detectados por linters
- Ser vago o poco claro sobre lo que necesita cambiar
- Hacer la retroalimentación sobre la persona en lugar del código
- Omitir retroalimentación positiva cuando el código está bien hecho
Preguntas frecuentes
¿Qué hace esta habilidad?
¿Puede esta habilidad analizar mi código automáticamente?
¿Qué tipos de revisiones de código abarca?
¿Cómo debo dar retroalimentación que los desarrolladores aceptarán?
¿Cuánto tiempo debe tomar una revisión de código?
¿Esto funciona con plataformas específicas como GitHub?
Detalles del desarrollador
Autor
wshobsonLicencia
MIT
Repositorio
https://github.com/wshobson/agents/tree/main/plugins/developer-essentials/skills/code-review-excellenceRef.
main
Estructura de archivos
📄 SKILL.md