open-pr
Redacta un pull request para la rama actual rellenando la plantilla de PR del repositorio en función de los cambios de la rama. Úsalo cuando la persona pida abrir/crear un PR, preparar un pull request
SKILL.md.claude/skills/open-pr/SKILL.md
GitHubPrepara un pull request para la rama actual.
Antes de redactar nada, deja el cambio listo. Es el único momento en que alguien mira el conjunto completo, y lo que no se actualice aquí no se actualiza nunca:
- Corre el subagente
doc-keepersobre el diff: sincronizadocs/architecture/*, los diagramas (entidades, pantallas, auth, componentes), el ADR si hubo decisión, la entrada delCHANGELOG.mdy el ítem del roadmap que la spec declaró. - Corre
bash .githooks/pre-push: los siete checks del CI, en unos quince segundos y sin gastar minutos de Actions. - Repasa
docs/conventions/definition-of-done.md, y en especial lo que ninguna máquina comprueba: revisión humana del esquema, autorización probada con otro rol, los cuatro estados de la UI.
Si algo queda en rojo, no abras el PR: dilo y arréglalo primero. Un PR que nace rojo se normaliza y deja de mirarse.
- Corre el subagente
Lee
.github/PULL_REQUEST_TEMPLATE.mdpara conocer las secciones requeridas y la lista de verificación.Reúne contexto sobre los cambios de la rama:
git log <base>..HEAD --onelinepara la lista de commits (la base suele sermain).git diff <base>...HEAD --staty revisa los diffs relevantes.
Rellena cada sección de la plantilla usando ese contexto:
- Resumen de qué cambió y por qué.
- Issues vinculados / ADRs o especificaciones relacionados si se mencionan.
- Notas de pruebas (qué ejecutaste o qué debería revisar quien haga la revisión).
- Marca los ítems de la lista de verificación que realmente apliquen; deja el resto para la persona autora.
Crea el PR con la CLI
gh(p. ej.gh pr create --title ... --body ...) si la rama está pusheada; de lo contrario, muestra la plantilla rellenada para que la persona la pegue.Informa la URL del PR o el cuerpo redactado.
NO hagas merge, NO apruebes, y NO marques ítems de la lista de verificación que no estén realmente hechos. Escribe un PR en borrador si el trabajo está incompleto.