TrackerJo/anexos-pr-github

Anexos de PR do GitHub

O próprio GitHub é o host aprovado para capturas de tela e gravações de PR do BuildPurdue. Este skill transforma evidências locais ignoradas em anexos de PR hospedados no GitHub, sem comprometer a mídia no repositório.

Use este skill após o visual-proof capturar as evidências e antes de marcar um PR visível ao usuário como pronto.

Pré-condições

1. Confirme que os arquivos de evidência existem e estão sob artifacts/ (ignorado).
2. Confirme se o GitHub CLI está autenticado para este repositório com gh auth status.
3. Confirme se o CLI instalado suporta anexos verificando a ajuda do comando relevante, por exemplo gh pr edit --help, para --attach.
4. Confirme se o PR alvo e o commit mais recente enviado são os que estão sendo comprovados.

Não deduza suporte a anexos a partir da string de versão do gh quando o próprio comando pode responder diretamente.

Fluxo de trabalho preferido: corpo com evidências incorporadas

Quando as capturas de tela precisam de legendas, tabelas de antes/depois ou uma ordem específica, escreva o corpo do PR em um arquivo Markdown local ignorado e faça referência aos caminhos de mídia local normalmente:

## Evidências visuais

| Antes | Depois |
| --- | --- |
| ![Antes: página do evento no celular](artifacts/event-before-phone.png) | ![Depois: página do evento no celular](artifacts/event-after-phone.png) |

[Gravação da interação](artifacts/event-flow.mp4)

Em seguida, publique o corpo e anexe cada arquivo de mídia referenciado no mesmo 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

O GitHub CLI envia os arquivos e reescreve as referências Markdown locais correspondentes para as URLs de anexo resultantes hospedadas no GitHub. Isso é preferível a colar URLs manualmente porque o corpo permanece legível antes do upload e o GitHub possui as URLs finais.

Evidências somente anexadas

Quando o layout não importa, uma imagem ou vídeo pode ser anexado sem substituir o corpo do PR:

gh pr edit <pr> --attach 'artifacts/after.png#Depois: layout móvel corrigido'

Repita --attach para vários arquivos. Use texto alternativo útil para capturas de tela. Vídeos não aceitam texto alternativo.

Para um comentário de evidência em vez do corpo do PR:

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

Verificar publicação

Trate o código de saída do comando e o próprio PR como verificações separadas. O GitHub pode enviar com sucesso alguns arquivos enquanto outro anexo falha.

Após cada upload:

1. Verifique o status de saída do comando.
2. Releia o corpo ou comentário do PR do GitHub.
3. Confirme se cada caminho local necessário foi substituído por uma URL hospedada no GitHub.
4. Confirme se não há anexos duplicados causados por um caminho Markdown local incompatível.
5. Abra a mídia publicada no PR quando o harness ativo for compatível.
6. Confirme se a mídia comprova o commit mais recente enviado e não contém segredos, tokens, dados pessoais, endereços de e-mail, OTPs ou conteúdo de usuário não relacionado.

Se algum anexo necessário estiver faltando ou desatualizado, o PR não está pronto.

Restrições rígidas

• Nunca cometa capturas de tela ou gravações apenas de PR. Não adicione .github/pr-assets/, public/pr-assets/, mídia de docs ou outro diretório de ativos rastreado apenas para tornar as evidências vinculáveis.
• Nunca use um host de arquivos terceirizado para evidências de PR do BuildPurdue, a menos que o usuário aprove explicitamente esse host para o caso específico.
• Nunca invente, preveja ou construa manualmente URLs de anexos. Use apenas URLs retornadas ou escritas pelo GitHub.
• Nunca enfraqueça o requisito de prova visual porque a ferramenta de upload está faltando. Se --attach não estiver disponível, relate esse pré-requisito exato e mantenha o PR não pronto.
• Nunca publique capturas confidenciais. Redija ou recapture antes do upload.
• Mantenha as evidências locais em artifacts/; elas estão intencionalmente no gitignore e podem ser excluídas após a verificação das evidências hospedadas no GitHub.

Por que isso existe

Isso segue a mesma regra operacional do T3 Code: alterações visíveis ao usuário carregam evidências visuais revisáveis, essas evidências são enviadas para o GitHub e capturas de tela apenas de PR nunca são cometidas no histórico do produto.

O recurso de anexo do CLI do GitHub se comporta como colar/arrastar no navegador: ele envia a imagem ou vídeo para o GitHub e insere a URL hospedada no PR ou comentário.

Fontes

• Regras do contribuidor T3 Code: https://github.com/pingdotgg/t3code/blob/main/AGENTS.md
• Documentação de anexo do GitHub CLI: https://docs.github.com/en/github-cli/github-cli/attaching-files-with-github-cli
• Manual gh pr edit --attach: https://cli.github.com/manual/gh_pr_edit

Fonte

Edite esta cópia em .agents/skills/. O hook de pré-commit a espelha em .claude/skills/; não edite o espelho diretamente.