Reparar PR
Lee comentarios de revisión, implementa correcciones, sube cambios y responde a los hilos.
Invocar
/fix-pr # repara el PR de la rama actual
/fix-pr 42 # repara el PR #42
Flujo
1. Identificar y cambiar al PR
gh pr view <PR> --json number,title,headRefName,state
Rechazar si el PR está cerrado o fusionado.
Si la rama actual no es la rama del PR (el pipeline de /developer ejecuta esto en un árbol de trabajo limpio), cambiarse primero:
gh pr checkout <PR>
Nunca ejecutar git checkout main — en un árbol de trabajo vinculado falla porque main está en el árbol de trabajo principal.
2. Leer todos los comentarios
# Comentarios generales
gh pr view <PR> --comments
# Hilos en línea (inline)
gh api repos/{owner}/{repo}/pulls/<PR>/comments \
--jq '[.[] | {id, path, line, body, in_reply_to_id}]'
# Resúmenes de revisión
gh api repos/{owner}/{repo}/pulls/<PR>/reviews \
--jq '[.[] | select(.body != "") | {id, state, body}]'
Recopilar: hilos en línea no resueltos, comentarios de resumen de revisión, comentarios generales del PR.
Rechazar si no hay nada que hacer — no se encontró retroalimentación.
3. Implementar correcciones
- Abordar cada comentario no resuelto
- Mantener cambios mínimos — solo lo que solicita la retroalimentación
- No refactorizar código no relacionado
- Después de aplicar todas las correcciones: ejecutar las verificaciones del proyecto (ver
AGENTS.md/CLAUDE.mdpara los comandos exactos), típicamente:
pnpm typecheck
pnpm test
Corregir fallos antes de hacer commit.
4. Commit y push
git add <archivos que modificó> # agregar por ruta — nunca `git add -p` (interactivo) ni `git add -A`
git commit -m "fix(pr): atender comentarios de revisión en #<PR>"
git push origin <rama>
5. Responder a los hilos
Por cada hilo atendido, responder:
gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="Corregido en <commit-sha>: <descripción de una línea de lo que cambió>."
6. Reportar
Listar cada comentario atendido y qué se hizo. Indicar cualquier comentario omitido y por qué.
Reglas
- Un solo commit para todas las correcciones (no uno por comentario)
- Responder a cada hilo que se atiende
- Si un comentario no es claro: hacer la interpretación más razonable, implementarla y declarar la interpretación en la respuesta del hilo (sin atención — no hay a quién preguntar). Si un comentario es incorrecto, decir por qué en la respuesta en lugar de implementarlo
- Si una corrección rompe pruebas: reportarlo, no hacer push forzado de código roto
- No resolver hilos — GitHub los resuelve automáticamente al hacer push