Skip to content

Esta página se tradujo del original en coreano con IA y puede contener errores.

Capítulo 6. PR y revisión — mirar una vez más antes de fusionar ​

En una línea: un PR (Pull Request) es proponer que los cambios de mi rama se fusionen en main. Te da un lugar donde discutir y revisar antes de fusionar. Aunque lo hayas creado tú solo, se hace revisión. Recibe también la revisión de la IA (/code-review), pero que diga «sin problemas» no significa que sea seguro, y la decisión de fusionar es mía.

Este capítulo se escribió con la documentación oficial de GitHub y Claude Code consultada el 1 de noviembre de 2026.

Qué es un PR ​

Un PR es la propuesta de fusionar los cambios de una rama en otra. Te da un lugar donde discutir y revisar antes de que entren en el proyecto.[1]

La pantalla del PR tiene estas pestañas.[2]

PestañaQué muestra
ConversationDescripción, comentarios y revisiones
CommitsCómo fue cambiando la rama
ChecksResultados de pruebas automáticas y de la construcción (capítulo 5)
Files changedLos cambios sobre los que comentan los revisores

Fuente: documentación oficial de GitHub (se trasladó solo una parte)[2:1]

Al crear un PR, escribes qué cambiaste y qué problema resuelve. Si es un PR que resuelve la incidencia (issue) del capítulo 8, enlázalo con la incidencia; si lo enlazas con una palabra establecida, la incidencia se cierra sola cuando se fusiona el PR.[3]

Un PR pequeño es más fácil de revisar y más seguro de fusionar. Antes de pedir a otra persona que lo revise, revísalo primero tú. Lee los cambios, mira si has cambiado algo sin querer y comprueba que se hayan ejecutado la construcción y las pruebas.[4]

También puedes pedirle a Claude Code que cree el PR. La documentación oficial recomienda revisar el PR creado por Claude antes de enviarlo y pedirle que señale los puntos de riesgo.[5]

Crea un PR con la rama first-board. Antes de enviarlo, señálame primero los puntos que podrían ser arriesgados en este cambio.

Comprueba lo aprendido

¿Qué afirmación sobre un PR (Pull Request) es correcta?

Aunque estés solo, revisa ​

El tutorial de GitHub dice que, incluso trabajando solo, el hábito de revisar con intención antes de fusionar mantiene sano el proyecto y facilita la colaboración posterior.[6]

Una revisión termina con una de tres decisiones.[7]

DecisiónSignificado
CommentSolo deja una opinión
ApproveEstá listo para fusionar
Request changesHay que corregirlo antes de fusionar

Fuente: documentación oficial de GitHub[7:1]

El criterio de la revisión es el SPEC.md del capítulo 3. El prompt de ejemplo del documento oficial de buenas prácticas hace que, cuando termines de crear, se contraste con SPEC.md para comprobar que se han implementado todos los requisitos, que solo se informe de los huecos que afectan a la corrección y que se salte el estilo (el ejemplo se lo encarga a un subagente, pero esta guía lo cambia a una sesión nueva).[8] También da el motivo: si le pides que busque problemas, el revisor siempre encuentra algo.[9] Y si intentas corregirlo todo, acaban saliendo añadidos innecesarios.

En una sesión nueva, revisa los cambios de la rama actual contrastándolos con SPEC.md. Mira si se han implementado todos los requisitos y si cada criterio de comprobación tiene su prueba, y dime solo los huecos que afecten a la corrección. Salta el estilo.

Comprueba lo aprendido

Al pedir una revisión frente a SPEC.md, ¿por qué dice la documentación oficial que te saltes el estilo?

Recibir la revisión de la IA ​

Claude Code tiene el comando de revisión /code-review. Si lo escribes en la sesión en la que estás trabajando, lee los cambios de mi rama, busca problemas de corrección y te los cuenta en la conversación.[10] El uso se cuenta en mi plan igual que el resto de la sesión.[11]

En la aplicación de escritorio puedes recibir la revisión escribiendo /code-review en el cuadro de entrada antes de hacer el commit.[12] Después de abrir el PR, en el panel de información de la sesión puedes ver el PR y el estado de las comprobaciones automáticas. Esta función necesita tener instalado GitHub CLI (gh) y haber iniciado sesión.[13]

La revisión de la IA tiene límites claros.

  • La revisión de la IA puede pasar por alto errores o problemas de seguridad. Que no encuentre nada no significa que no haya errores ni que sea seguro.[14]
  • La revisión gestionada que se añade automáticamente a los PR de GitHub tampoco aprueba ni bloquea el PR. La decisión de fusionar la toma una persona.[15] Esta revisión gestionada es para los planes Team y Enterprise, y a nivel personal se usa /code-review en cualquier plan.[16]

Si en la etapa 3 aprendiste a «separar a quien escribe de quien comprueba», aunque sea el mismo Claude, es mejor que haga la revisión en una sesión nueva, porque así no se deja arrastrar por el contexto de la conversación en la que lo creó.

Comprueba lo aprendido

¿Cómo debes interpretar que en una revisión de la IA no aparezca ningún problema?

Fusionar y ordenar ​

Cuando termina la revisión y pasa el mecanismo de comprobación, fusionas el PR (Merge). El último paso del GitHub flow es borrar la rama. Aunque borres la rama, el PR y el historial de commits no se borran, así que no hay que preocuparse.[17]

Más adelante, cuando haya más gente, puedes poner reglas de protección como «solo se puede fusionar con una aprobación». Por defecto, las reglas de protección impiden sobrescribir a la fuerza y borrar la rama.[18]

Comprueba lo aprendido

¿Qué pasa si borras la rama después de fusionar un PR?

Pruébalo tú ​

  1. Comprueba que la rama first-board está subida a GitHub (capítulo 4). En la pantalla principal del repositorio pulsa Pull requests → New pull request, elige first-board como rama a comparar y pulsa Create pull request.[19] En el título y la descripción escribe qué cambiaste y por qué.
  2. Antes de crearlo, pídele a Claude que señale los puntos de riesgo.
  3. En una sesión nueva, recibe una revisión contrastada con SPEC.md. Corrige solo los problemas de corrección.
  4. Pide otra vez /code-review y, aunque no encuentre nada, echa tú mismo un vistazo a la pestaña Files changed.
  5. Cuando pase el mecanismo de comprobación, fusiona el PR y ordena la rama.

Proyecto continuo: en el capítulo 7, publicarás en internet con GitHub Pages el tablero de tareas ya fusionado.

Resumen ​

  • El PR es un lugar donde discutir y revisar antes de fusionar. Hazlo pequeño, escribe qué cambiaste y por qué, y revísalo tú primero.
  • Aunque estés solo, revisa. El criterio es SPEC.md; solo se corrigen los huecos de corrección y se salta el estilo.
  • /code-review se usa en cualquier plan. Que no encuentre nada no significa que sea seguro, y la decisión de fusionar la toma una persona.
  • Después de fusionar, aunque borres la rama, el PR y el historial de commits se quedan.

Glosario ​

TérminoEn españolEn una línea
Pull Request (PR)Solicitud de extracción (PR)La propuesta de fusionar los cambios de una rama
ReviewRevisiónExaminar los cambios antes de fusionar
MergeFusionarJuntar los cambios de la rama
/code-reviewRevisión de códigoEl comando de revisión de Claude Code

¿Terminaste este capítulo?

El progreso se guarda solo en este navegador. Puedes ver tu avance en el índice completo.

Siguiente capítulo: Capítulo 7. Publicar

Referencias (19)
  1. Documentación oficial de GitHub, «About pull requests». "A pull request proposes merging code changes from one branch into another. As a collaborative feature, pull requests give you a place to discuss and review work before it becomes part of a project." docs.github.com (consultado el 2026-11-01) ↩︎

  2. Documentación oficial de GitHub, «About pull requests». "Checks shows the results of automated tests, builds, and other validations." / "Files changed shows the diff that reviewers comment on." docs.github.com (consultado el 2026-11-01) ↩︎

  3. Documentación oficial de GitHub, «GitHub flow». "When you create a pull request, include a summary of the changes and what problem they solve." / "If you link with a keyword, the issue will close automatically when the pull request merges." docs.github.com (consultado el 2026-11-01) ↩︎

  4. Documentación oficial de GitHub, «Helping others review your changes». "Small, focused pull requests are easier to review and safer to merge." / "A self-review can include reading the diff, checking for accidental changes, and making sure relevant builds or tests have run." docs.github.com (consultado el 2026-11-01) ↩︎

  5. Documentación oficial de Claude Code, «Common workflows». "Review Claude's generated PR before submitting and ask Claude to highlight potential risks or considerations." code.claude.com (consultado el 2026-11-01) ↩︎

  6. Documentación oficial de GitHub, «Reviewing your proposed changes». "Even when you work alone, a deliberate review builds a habit that keeps your software projects healthy and makes collaboration easier later." docs.github.com (consultado el 2026-11-01) ↩︎

  7. Documentación oficial de GitHub, «Quickstart for reviewing pull requests». "Approve signals that the changes are ready to merge." / "Request changes flags feedback the author must address before merging." docs.github.com (consultado el 2026-11-01) ↩︎

  8. Documentación oficial de Claude Code, «Best practices for Claude Code». "use a subagent to review the rate limiter diff against SPEC.md, check every requirement is implemented and the listed edge cases have tests, report gaps that affect correctness and skip style" code.claude.com (consultado el 2026-11-01) ↩︎

  9. Documentación oficial de Claude Code, «Best practices for Claude Code». "A reviewer that's asked to find problems will always find something." code.claude.com (consultado el 2026-11-01) ↩︎

  10. Documentación oficial de Claude Code, «Review locally with /code-review». "Claude reviews the changes on your branch, looks for correctness bugs, and reports what it found in your conversation." code.claude.com (consultado el 2026-11-01) ↩︎

  11. Documentación oficial de Claude Code, «Review locally with /code-review». "The review runs in your own session, so it counts toward your plan's usage or API billing the same way the rest of the session does." code.claude.com (consultado el 2026-11-01) ↩︎

  12. Documentación oficial de Claude Code, «Desktop application». "To have Claude review your changes before you commit, enter /code-review in the prompt box." code.claude.com (consultado el 2026-11-01) ↩︎

  13. Documentación oficial de Claude Code, «Desktop application». "After you open a pull request, it appears in the Changes card of the session details panel with the status of its CI checks." / "PR monitoring requires the GitHub CLI (gh) to be installed and authenticated on your machine." code.claude.com (consultado el 2026-11-01) ↩︎

  14. Documentación oficial de Claude Code, «Code Review». "Code Review uses AI to review code and may miss bugs, security vulnerabilities, or other issues. A review with no findings doesn't mean your code is error-free or secure." code.claude.com (consultado el 2026-11-01) ↩︎

  15. Documentación oficial de Claude Code, «Code Review». "A review never approves or blocks the pull request, so the decision to merge stays with your team." code.claude.com (consultado el 2026-11-01) ↩︎

  16. Documentación oficial de Claude Code, «Code Review». "Plans: Team and Enterprise" / "Run /code-review in your Claude Code session on any plan, or compare all the options." code.claude.com (consultado el 2026-11-01) ↩︎

  17. Documentación oficial de GitHub, «GitHub flow». "Don't worry about losing information. Your pull request and commit history will not be deleted." docs.github.com (consultado el 2026-11-01) ↩︎

  18. Documentación oficial de GitHub, «About protected branches». "By default, each branch protection rule disables force pushes to the matching branches and prevents the matching branches from being deleted." docs.github.com (consultado el 2026-11-01) ↩︎

  19. Documentación oficial de GitHub, «Quickstart for pull requests». "then click New pull request." / "For the compare branch, select the branch that contains your changes." / "Click Create pull request." docs.github.com (consultado el 2026-11-01) ↩︎