receiving-code-review

Descripción general

Qué hace la skill receiving-code-review

La skill receiving-code-review define un patrón claro y repetible sobre cómo debe responder un agente cuando recibe feedback de revisión de código, especialmente en pull requests de GitHub. Se centra en la evaluación técnica por encima de la performance social.

En lugar de estar de acuerdo a ciegas con las personas revisoras o implementar sugerencias de inmediato, esta skill entrena al agente para:

• Leer todos los comentarios antes de reaccionar
• Reformular o aclarar el cambio solicitado
• Verificar el feedback contra la base de código real
• Evaluar si la sugerencia es técnicamente correcta para ese repositorio
• Responder con razonamiento técnico fundamentado, no con halagos
• Implementar cambios uno por uno, solo después de entender y verificar

A quién va dirigida esta skill

Usa receiving-code-review si:

• Trabajas con un asistente de IA en PRs de GitHub o conversaciones de revisión de código
• Quieres que el asistente actúe como una persona revisora/autor reflexiva, no como alguien que solo dice que sí
• Necesitas ayuda para interpretar comentarios de revisión y decidir qué hacer después
• Te importa más la corrección y la seguridad de los cambios que un acuerdo rápido pero superficial

Es especialmente útil para:

• Desarrolladores que colaboran en feature branches y pull requests
• Tech leads que quieren un tratamiento consistente del feedback de revisión
• Equipos que experimentan con Claude u otros LLMs como compañeros de revisión de PR

Cuándo no es una buena opción esta skill

Esta skill no está diseñada para:

• Generar nuevas funcionalidades desde cero
• Refactors a gran escala sin contexto de revisión
• Cortesías sociales, elogios o actualizaciones de estado

Si principalmente quieres generación de código, redacción de documentación o ayuda con diseño de alto nivel, combínala con otras skills. Usa receiving-code-review específicamente cuando el agente esté en el bucle de recibir y responder a feedback de revisión de código.

Beneficios clave

Con receiving-code-review instalada, tu agente:

• Evitará respuestas performativas como "You're absolutely right!" o "Great point!"
• Basará sus respuestas en el código real, no en suposiciones
• Pedirá aclaraciones en lugar de adivinar cuando el feedback sea poco claro
• Rebatirá con respeto cuando una sugerencia sea técnicamente incorrecta
• Reducirá el riesgo de implementar cambios mal entendidos o dañinos

Esto facilita confiar en el agente dentro de tus procesos de code-review, git-workflows y pr-review.

Cómo usarla

1. Instalación

Para instalar la skill receiving-code-review desde el repositorio obra/superpowers, ejecuta:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Este comando descarga la definición de la skill (incluido SKILL.md) en el entorno de skills de tu agente. La instalación asume que ya tienes la herramienta npx skills; si no es así, configúrala primero según las instrucciones de tu plataforma o host del agente.

2. Archivos que revisar tras la instalación

Después de instalar, revisa el archivo principal de esta skill:

• skills/receiving-code-review/SKILL.md – descripción canónica del patrón de comportamiento al recibir feedback de revisión de código.

En el repositorio más amplio obra/superpowers puedes encontrar patrones compartidos como:

• README.md, AGENTS.md o metadata.json en la raíz – contexto general sobre cómo se estructuran y usan las skills

Estos archivos ayudan a entender cómo encaja receiving-code-review en un conjunto de reglas más amplio para Claude/agentes, pero el corazón operativo de esta skill está en SKILL.md.

3. Flujo de respuesta principal

La skill define un patrón específico de respuesta siempre que el agente reciba feedback de revisión de código (por ejemplo, en un hilo de comentarios de un PR de GitHub):

1. READ:     Consume all feedback before reacting
2. UNDERSTAND: Restate the requirement in its own words, or ask
3. VERIFY:   Check the feedback against the real codebase
4. EVALUATE: Decide if it is technically sound for THIS repo
5. RESPOND:  Give a technical acknowledgment or reasoned pushback
6. IMPLEMENT: Change one item at a time and test each

En la práctica, esto significa:

• El agente no debe decir inmediatamente que va a implementar una sugerencia.
• Primero debe asegurarse de entender qué quiere la persona revisora.
• Debe inspeccionar los archivos/líneas relevantes o el estado del repositorio.
• Solo entonces decide si aplica, modifica o rechaza la sugerencia.

Este patrón es especialmente útil en escenarios de GitHub pull request review, donde el contexto y la corrección importan más que la velocidad.

4. Respuestas prohibidas y desaconsejadas

La skill prohíbe explícitamente ciertos tipos de respuestas que son habituales en LLMs pero dañinas en revisiones de código serias:

Ejemplos prohibidos:

• "You're absolutely right!" (identificado explícitamente como una violación de las reglas más amplias de CLAUDE)
• "Great point!" / "Excellent feedback!" y respuestas similares de elogio vacío
• "Let me implement that now" cuando el agente aún no ha verificado la sugerencia

En su lugar, al usar receiving-code-review, el agente debe:

• Reformular el requisito técnico: por ejemplo, "You are asking to extract this logic into a separate function to avoid duplication."
• Hacer preguntas específicas cuando algo no esté claro
• Aportar razonamiento técnico cuando considere que la sugerencia es incorrecta o incompleta
• Avanzar hacia los cambios reales sin sobreexplicar ni elogiar en exceso

Así la conversación se mantiene centrada en la calidad del código, no en los halagos.

5. Gestión de feedback poco claro o parcial

La skill define una regla estricta para feedback ambiguo:

IF any item in the feedback is unclear:
  STOP – do not implement anything yet
  ASK for clarification on the unclear items

La razón: los puntos individuales de revisión pueden estar relacionados, por lo que implementar solo los que "crees" entender mientras otros siguen siendo ambiguos puede llevar a:

• Cambios que entran en conflicto
• Flujos de trabajo rotos
• Comportamientos que no se alinean con la intención de la persona revisora

Por ejemplo, si alguien dice "Fix 1–6" y el agente solo entiende los puntos 1, 2, 3 y 6, receiving-code-review le guía a:

• Pausar la implementación
• Hacer preguntas de aclaración específicas sobre los puntos 4 y 5
• Implementar solo cuando se entienda el conjunto completo de requisitos

Este comportamiento es clave en flujos de trabajo git automatizados o semiautomatizados, donde una comprensión parcial puede romper ramas con rapidez.

6. Integración con tu flujo de trabajo GitHub / PR

Para sacarle el máximo partido a receiving-code-review en un proyecto real:

1. Asocia la skill a tu agente que se use para:

   • Revisar pull requests
   • Redactar respuestas a comentarios de revisión
   • Ayudar a priorizar o resumir feedback de revisión

2. Garantiza acceso al repositorio para que el agente pueda verificar las sugerencias frente a:

   • El código de la rama actual
   • Archivos y módulos relevantes

3. Combínala con skills complementarias para mejores resultados, por ejemplo:

   • Una skill de coding o refactoring para implementar los cambios acordados
   • Skills de navegación o búsqueda en el repositorio para localizar rápidamente el código afectado

4. Explica a tu equipo que el agente va a:

   • Hacer preguntas de aclaración en lugar de adivinar
   • Rebatir a veces sugerencias incorrectas o arriesgadas
   • Evitar elogios genéricos a favor de respuestas técnicas específicas

Integrada de esta manera, receiving-code-review actúa como un carril de seguridad que mantiene a tu colaborador de IA disciplinado y fiable en conversaciones de revisión de código.

7. Cuándo activar esta skill

Usa receiving-code-review siempre que tu prompt o flujo de trabajo indique que el agente está:

• Leyendo feedback humano o de bots sobre un pull request
• Revisando comentarios en línea en vistas de diff de GitHub
• Procesando notas de revisión en una herramienta de code-review

En general no la necesitas cuando:

• Generas el código inicial o el primer borrador de una funcionalidad
• Redactas documentos de diseño o ADRs
• Realizas tareas que no son de revisión, como actualizaciones de dependencias

Activar la skill solo en contextos de revisión mantiene el comportamiento del agente predecible y enfocado.

Preguntas frecuentes

¿Qué problema resuelve receiving-code-review?

La skill receiving-code-review resuelve el problema de respuestas de IA superficiales y performativas ante feedback de revisión de código. En lugar de asentir siempre e introducir cambios de inmediato, el agente:

• Lee todos los comentarios
• Los contrasta con la base de código existente
• Aclara las peticiones ambiguas
• Rebate con razonamiento técnico cuando es necesario

Esto reduce de forma significativa implementaciones incorrectas y malentendidos en PRs de GitHub y otras herramientas de code-review.

¿Cómo instalo receiving-code-review?

Instala la skill desde el repositorio obra/superpowers usando:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Tras la instalación, revisa SKILL.md dentro del directorio de la skill receiving-code-review para entender las reglas de comportamiento exactas.

¿Esta skill cambia cómo se escribe el código?

Indirectamente. receiving-code-review no genera código por sí misma, pero influye de forma importante en cómo y cuándo se realizan los cambios al código al imponer:

• Verificación antes de implementar
• Cambios y pruebas punto por punto
• Evitar arreglos parciales o mal entendidos

Combínala con skills de coding para gestionar la implementación real una vez validado el feedback de revisión.

¿Puede receiving-code-review rebatir a una persona revisora humana?

Sí. La skill permite y fomenta explícitamente el rechazo razonado y técnico cuando el feedback:

• Es incorrecto para la base de código actual
• Se basa en suposiciones desactualizadas
• Probablemente introducirá bugs o regresiones

El desacuerdo debe basarse en detalles concretos del repositorio, no en opiniones.

¿Esta skill es solo para GitHub?

La skill está escrita pensando en flujos de trabajo de PR review al estilo GitHub, pero aplica a cualquier entorno donde un agente reciba feedback estructurado de revisión de código, incluidos:

• Herramientas de revisión de código basadas en git
• Paneles internos de revisión
• Sesiones de revisión en chat donde los comentarios referencian archivos y líneas concretas

Si tu flujo de trabajo se parece a comentarios de PR más un repositorio git, receiving-code-review encaja bien.

¿Cómo interactúa esto con CLAUDE u otras reglas del agente?

En el ecosistema obra/superpowers, las skills se combinan con reglas de nivel superior (a menudo en archivos como CLAUDE.md). receiving-code-review hace referencia a esas expectativas al prohibir respuestas como "You're absolutely right!" que van contra el espíritu de esas reglas.

Úsala junto con tus reglas actuales del agente para:

• Imponer un comportamiento de revisión más estricto
• Evitar la sobre-optimización social
• Mantener consistencia entre distintos proyectos y repositorios

¿Y si mi equipo prefiere respuestas más educadas?

Puedes seguir manteniendo un tono profesional, pero esta skill prioriza la comunicación técnica clara sobre las fórmulas de cortesía. Si necesitas un tono más suave, puedes:

• Añadir guías de tono en otras skills
• Mantener receiving-code-review como la base para la verificación y el rigor

Esta separación te permite ajustar el estilo sin debilitar la disciplina de revisión.

¿Cómo sé si esta skill está funcionando correctamente?

Señales de que receiving-code-review está activa y funcionando bien incluyen:

• El agente ya no responde con elogios genéricos a los comentarios de revisión
• Reformula los requisitos antes de actuar
• Hace preguntas cuando el feedback es incompleto o ambiguo
• Hace referencia a archivos, funciones o líneas concretas al aceptar o cuestionar sugerencias

Si ves respuestas del tipo "I’ll implement that" de inmediato sin verificación, revisa la configuración de tus skills y asegúrate de que esta skill esté habilitada en contextos de revisión.