sgomez/developer-skills

Entrega automatizada de PRDs para Claude Code

¿Qué es developer-skills?

Esta habilidad para Claude Code automatiza el proceso de corregir Pull Requests basándose en comentarios de revisión. Cuando se invoca con `/fix-pr`, la habilidad identifica el PR actual o uno específico, lee todos los comentarios de revisión (incluyendo hilos en línea, resúmenes y comentarios generales), e implementa correcciones mínimas para cada comentario no resuelto. Después de aplicar los cambios, ejecuta las verificaciones del proyecto (como typecheck y pruebas) para asegurar que el código no esté roto, luego realiza un commit único y lo sube al branch. Finalmente, responde automáticamente a cada hilo indicando qué se corrigió. Es útil para equipos que quieren acelerar el ciclo de revisión de PRs, delegando las correcciones mecánicas a un agente de IA sin intervención manual. Funciona exclusivamente con Claude Code y requiere acceso a GitHub CLI (gh) y la API de GitHub.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add sgomez/developer-skills

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.md para 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

Skills relacionados