TrackerJo/pièces-jointes-github-pr

Pièces jointes GitHub pour PR

GitHub lui-même est l'hôte approuvé pour les captures d'écran et enregistrements de PR de BuildPurdue. Cette compétence transforme les preuves locales ignorées en pièces jointes hébergées sur GitHub sans commiter de médias dans le dépôt.

Utilisez cette compétence après que visual-proof a capturé les preuves et avant qu'une PR visible par l'utilisateur ne soit déclarée prête.

Prérequis

1. Confirmez que les fichiers de preuve existent et se trouvent sous le répertoire ignoré artifacts/.
2. Confirmez que GitHub CLI est authentifié pour ce dépôt avec gh auth status.
3. Confirmez que l'interface CLI installée prend en charge les pièces jointes en vérifiant l'aide de la commande concernée, par exemple gh pr edit --help, pour --attach.
4. Confirmez que la PR cible et le dernier commit poussé sont ceux en cours de validation.

N'inférez pas la prise en charge des pièces jointes à partir de la chaîne de version de gh lorsque la commande elle-même peut répondre directement.

Workflow privilégié : corps avec preuves intégrées

Lorsque les captures d'écran nécessitent des légendes, des tableaux avant/après ou un ordre spécifique, rédigez le corps de la PR dans un fichier Markdown local ignoré et référencez les chemins média locaux normalement :

## Preuve visuelle

| Avant | Après |
| --- | --- |
| ![Avant : page d'événement mobile](artifacts/event-before-phone.png) | ![Après : page d'événement mobile](artifacts/event-after-phone.png) |

[Enregistrement d'interaction](artifacts/event-flow.mp4)

Publiez ensuite le corps et attachez chaque fichier média référencé dans la même commande :

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 téléverse les fichiers et réécrit les références Markdown locales correspondantes en URLs de pièces jointes hébergées par GitHub. Ceci est préférable à la copie manuelle d'URLs car le corps reste lisible avant le téléversement et GitHub possède les URLs finales.

Preuve par ajout simple

Lorsque la mise en page importe peu, une image ou une vidéo peut être ajoutée sans remplacer le corps de la PR :

gh pr edit <pr> --attach 'artifacts/after.png#After: corrected mobile layout'

Répétez --attach pour plusieurs fichiers. Utilisez un texte alternatif utile pour les captures d'écran. Les vidéos n'acceptent pas de texte alternatif.

Pour un commentaire de preuve au lieu du corps de la PR :

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

Vérifier la publication

Traitez le code de sortie de la commande et la PR elle-même comme des vérifications distinctes. GitHub peut téléverser certains fichiers avec succès tandis qu'une autre pièce jointe échoue.

Après chaque téléversement :

1. Vérifiez le code de sortie de la commande.
2. Relisez le corps ou le commentaire de la PR depuis GitHub.
3. Confirmez que chaque chemin local requis a été remplacé par une URL hébergée par GitHub.
4. Confirmez qu'il n'y a pas de pièces jointes ajoutées en double causées par un chemin Markdown local mal assorti.
5. Ouvrez le média publié depuis la PR lorsque le harnais actif le prend en charge.
6. Confirmez que le média prouve le dernier commit poussé et ne contient aucun secret, jeton, donnée personnelle, adresse e-mail, OTP ou contenu utilisateur non lié.

Si une pièce jointe requise est manquante ou obsolète, la PR n'est pas prête.

Restrictions strictes

• Ne commettez jamais de captures d'écran ou d'enregistrements propres aux PR. N'ajoutez pas de répertoire .github/pr-assets/, public/pr-assets/, de médias de documentation ou un autre répertoire d'actifs suivi simplement pour rendre la preuve liable.
• N'utilisez jamais un hébergeur de fichiers tiers pour les preuves de PR de BuildPurdue, sauf si l'utilisateur approuve explicitement cet hébergeur pour le cas spécifique.
• N'inventez, ne prédisez et ne construisez jamais manuellement des URLs de pièces jointes. N'utilisez que les URLs retournées ou écrites par GitHub.
• N'affaiblissez jamais l'exigence de preuve visuelle parce que l'outil de téléversement est absent. Si --attach est indisponible, signalez ce prérequis exact et maintenez la PR non prête.
• Ne publiez jamais de captures sensibles. Rédigez ou recapturez avant le téléversement.
• Conservez les preuves locales dans artifacts/ ; ce répertoire est intentionnellement dans gitignore et peut être supprimé après vérification des preuves hébergées par GitHub.

Pourquoi cela existe

Cela suit la même règle de fonctionnement que T3 Code : les modifications visibles par l'utilisateur portent une preuve visuelle révisable, cette preuve est téléversée sur GitHub, et les captures d'écran propres aux PR ne sont jamais commises dans l'historique du produit.

La fonctionnalité de pièces jointes de GitHub CLI se comporte comme le collage/dépôt dans le navigateur : elle téléverse l'image ou la vidéo sur GitHub et insère l'URL hébergée dans la PR ou le commentaire.

Sources

• Règles des contributeurs T3 Code : https://github.com/pingdotgg/t3code/blob/main/AGENTS.md
• Documentation des pièces jointes GitHub CLI : https://docs.github.com/en/github-cli/github-cli/attaching-files-with-github-cli
• Manuel gh pr edit --attach : https://cli.github.com/manual/gh_pr_edit

Source

Modifiez cette copie sous .agents/skills/. Le hook de pré-commit la reflète dans .claude/skills/ ; ne modifiez pas le miroir directement.