TrackerJo/github-pr-attachments

Adjuntos para PR de GitHub

GitHub mismo es el host aprobado para las capturas de pantalla y grabaciones de PR de BuildPurdue. Esta skill convierte evidencia local ignorada en adjuntos de PR alojados en GitHub sin comprometer medios en el repositorio.

Usa esta skill después de que visual-proof capture evidencia y antes de que un PR visible para el usuario se marque como listo.

Requisitos previos

1. Confirma que los archivos de evidencia existan y estén bajo el directorio ignorado artifacts/.
2. Confirma que GitHub CLI esté autenticado para este repositorio con gh auth status.
3. Confirma que la CLI instalada soporte adjuntos verificando la ayuda del comando relevante, por ejemplo gh pr edit --help, en busca de --attach.
4. Confirma que el PR objetivo y el último commit enviado sean los que se están verificando.

No infieras el soporte de adjuntos a partir de la cadena de versión de gh cuando el comando mismo puede responder directamente.

Flujo de trabajo preferido: cuerpo con evidencia incrustada

Cuando las capturas necesiten pies de foto, tablas de antes/después o un orden específico, escribe el cuerpo del PR en un archivo Markdown local ignorado y referencia las rutas de medios locales de forma normal:

## Evidencia visual

| Antes | Después |
| --- | --- |
| ![Antes: página móvil de eventos](artifacts/event-before-phone.png) | ![Después: página móvil de eventos](artifacts/event-after-phone.png) |

[Grabación de interacción](artifacts/event-flow.mp4)

Luego publica el cuerpo y adjunta cada archivo de medios referenciado en el mismo comando:

gh pr edit <pr> \
  --body-file artifacts/pr-body.md \
  --attach artifacts/event-before-phone.png \
  --attach artifacts/event-after-phone.png \
  --attach artifacts/event-flow.mp4

GitHub CLI sube los archivos y reescribe las referencias Markdown locales coincidentes a las URLs de adjunto resultantes alojadas en GitHub. Esto es preferible a pegar URLs manualmente porque el cuerpo sigue siendo legible antes de la subida y GitHub posee las URLs finales.

Evidencia solo de anexo

Cuando el diseño no importa, se puede anexar una imagen o video sin reemplazar el cuerpo del PR:

gh pr edit <pr> --attach 'artifacts/after.png#Después: diseño móvil corregido'

Repite --attach para múltiples archivos. Usa texto alternativo útil para las capturas de pantalla. Los videos no admiten texto alternativo.

Para un comentario de evidencia en lugar del cuerpo del PR:

gh pr comment <pr> \
  --body-file artifacts/evidence-comment.md \
  --attach artifacts/after.png \
  --attach artifacts/interaction.mp4

Verificar la publicación

Trata el código de salida del comando y el PR mismo como verificaciones separadas. GitHub puede subir algunos archivos correctamente mientras otro adjunto falla.

Después de cada subida:

1. Verifica el estado de salida del comando.
2. Vuelve a leer el cuerpo o comentario del PR desde GitHub.
3. Confirma que cada ruta local requerida fue reemplazada por una URL alojada en GitHub.
4. Confirma que no hay adjuntos duplicados causados por una ruta Markdown local no coincidente.
5. Abre los medios publicados desde el PR cuando el entorno activo lo soporte.
6. Confirma que los medios demuestren el último commit enviado y no contengan secretos, tokens, datos personales, direcciones de correo electrónico, OTPs o contenido de usuario no relacionado.

Si falta algún adjunto requerido o está desactualizado, el PR no está listo.

Restricciones estrictas

• Nunca subas capturas de pantalla o grabaciones exclusivas de PR. No agregues un directorio de activos como .github/pr-assets/, public/pr-assets/, medios de documentación u otro directorio rastreado solo para hacer enlazable la evidencia.
• Nunca uses un host de archivos de terceros para la evidencia de PR de BuildPurdue a menos que el usuario apruebe explícitamente ese host para el caso específico.
• Nunca inventes, predigas o construyas manualmente URLs de adjunto. Solo usa URLs devueltas o escritas por GitHub.
• Nunca debilites el requisito de evidencia visual porque falte la herramienta de subida. Si --attach no está disponible, reporta ese requisito exacto y mantén el PR como no listo.
• Nunca publiques capturas sensibles. Redacta o vuelve a capturar antes de subir.
• Mantén la evidencia local en artifacts/; está intencionalmente en gitignore y se puede eliminar después de verificar la evidencia alojada en GitHub.

Por qué existe esto

Esto sigue la misma regla operativa que T3 Code: los cambios visibles para el usuario llevan evidencia visual revisable, esa evidencia se sube a GitHub, y las capturas de pantalla exclusivas de PR nunca se comprometen en el historial del producto.

La función de adjuntos de la CLI de GitHub se comporta como pegar/arrastrar en el navegador: sube la imagen o video a GitHub e inserta la URL alojada en el PR o comentario.

Fuentes

• Reglas del colaborador de T3 Code: https://github.com/pingdotgg/t3code/blob/main/AGENTS.md
• Documentación de adjuntos de GitHub CLI: https://docs.github.com/en/github-cli/github-cli/attaching-files-with-github-cli
• Manual de gh pr edit --attach: https://cli.github.com/manual/gh_pr_edit

Fuente

Edita esta copia bajo .agents/skills/. El hook de pre-commit la refleja en .claude/skills/; no edites el espejo directamente.