GitHub PR 첨부 파일은(는) 무엇을 하나요?

GitHub 자체가 BuildPurdue PR 스크린샷과 녹화 파일의 승인된 호스트입니다. 이 스킬은 무시된 로컬 증거를 미디어를 저장소에 커밋하지 않고 GitHub 호스팅 PR 첨부 파일로 변환합니다.

visual-proof가 증거를 캡처한 후, 사용자가 볼 수 있는 PR이 준비되었다고 표시되기 전에 이 스킬을 사용하세요.

전제 조건

증거 파일이 존재하고 무시된 artifacts/ 디렉터리 아래에 있는지 확인합니다.
GitHub CLI가 gh auth status로 이 저장소에 대해 인증되었는지 확인합니다.
설치된 CLI가 gh pr edit --help와 같은 관련 명령어 도움말에서 --attach 옵션을 지원하는지 확인합니다.
대상 PR과 최신 푸시된 커밋이 증명하려는 것과 일치하는지 확인합니다.

gh 버전 문자열만으로 첨부 파일 지원 여부를 추론하지 말고, 명령어 자체가 직접 답변할 수 있을 때는 그렇게 하세요.

권장 워크플로: 증거가 포함된 본문

스크린샷에 캡션, 전/후 비교표, 또는 특정 순서가 필요한 경우 PR 본문을 무시된 로컬 마크다운 파일에 작성하고 로컬 미디어 경로를 일반적으로 참조합니다:

## 시각적 증거

| 전 | 후 |
| --- | --- |
| ![전: 모바일 이벤트 페이지](artifacts/event-before-phone.png) | ![후: 모바일 이벤트 페이지](artifacts/event-after-phone.png) |

[인터랙션 녹화](artifacts/event-flow.mp4)

그런 다음 동일한 명령에서 본문을 게시하고 참조된 모든 미디어 파일을 첨부합니다:

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는 파일을 업로드하고 일치하는 로컬 마크다운 참조를 결과 GitHub 호스팅 첨부 파일 URL로 다시 작성합니다. 이는 수동으로 URL을 붙여넣는 것보다 선호되는데, 그 이유는 본문이 업로드 전에 읽을 수 있고 GitHub가 최종 URL을 소유하기 때문입니다.

추가 전용 증거

레이아웃이 중요하지 않은 경우 이미지나 비디오를 PR 본문을 대체하지 않고 추가할 수 있습니다:

gh pr edit <pr> --attach 'artifacts/after.png#After: 수정된 모바일 레이아웃'

여러 파일에 대해 --attach를 반복합니다. 스크린샷에는 유용한 대체 텍스트를 사용하세요. 비디오는 대체 텍스트를 사용하지 않습니다.

PR 본문 대신 증거 댓글의 경우:

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

게시 확인

명령어 종료 코드와 PR 자체를 별도의 검사로 취급합니다. GitHub는 일부 파일을 성공적으로 업로드하는 동안 다른 첨부 파일이 실패할 수 있습니다.

모든 업로드 후:

명령어 종료 상태를 확인합니다.
PR 본문 또는 댓글을 GitHub에서 다시 읽습니다.
필요한 모든 로컬 경로가 GitHub 호스팅 URL로 대체되었는지 확인합니다.
일치하지 않는 로컬 마크다운 경로로 인해 중복 추가된 첨부 파일이 없는지 확인합니다.
활성 하네스가 지원하는 경우 PR에서 게시된 미디어를 엽니다.
미디어가 최신 푸시된 커밋을 증명하고 비밀, 토큰, 개인 데이터, 이메일 주소, OTP 또는 관련 없는 사용자 콘텐츠를 포함하지 않는지 확인합니다.

필수 첨부 파일이 누락되었거나 오래된 경우 PR은 준비되지 않습니다.

엄격한 제한 사항

PR 전용 스크린샷이나 녹화를 절대 커밋하지 마십시오. 증거를 링크 가능하게 만들기 위해 .github/pr-assets/, public/pr-assets/, 문서 미디어 또는 기타 추적된 자산 디렉터리를 추가하지 마십시오.
BuildPurdue PR 증거에 대해 제3자 파일 호스트를 절대 사용하지 마십시오. 사용자가 특정 경우에 대해 해당 호스트를 명시적으로 승인하지 않는 한 사용하지 마십시오.
첨부 파일 URL을 절대 만들거나 예측하거나 수동으로 구성하지 마십시오. GitHub에서 반환하거나 작성한 URL만 사용하십시오.
업로드 도구가 없기 때문에 visual-proof 요구 사항을 절대 약화시키지 마십시오. --attach를 사용할 수 없으면 해당 정확한 전제 조건을 보고하고 PR을 준비되지 않은 상태로 유지하십시오.
민감한 캡처를 절대 게시하지 마십시오. 업로드 전에 편집하거나 다시 캡처하십시오.
로컬 증거는 artifacts/에 보관하십시오. 이는 의도적으로 gitignore 처리되며 GitHub 호스팅 증거가 확인된 후 삭제할 수 있습니다.

존재 이유

이 스킬은 T3 Code와 동일한 운영 규칙을 따릅니다: 사용자에게 보이는 변경 사항은 검토 가능한 시각적 증거를 수반하고, 해당 증거는 GitHub에 업로드되며, PR 전용 스크린샷은 제품 기록에 절대 커밋되지 않습니다.

GitHub CLI 첨부 파일 기능은 브라우저의 붙여넣기/드래그 앤 드롭처럼 작동합니다: 이미지나 비디오를 GitHub에 업로드하고 호스팅된 URL을 PR 또는 댓글에 삽입합니다.

출처

T3 Code 기여자 규칙: https://github.com/pingdotgg/t3code/blob/main/AGENTS.md
GitHub CLI 첨부 파일 문서: https://docs.github.com/en/github-cli/github-cli/attaching-files-with-github-cli
gh pr edit --attach 매뉴얼: https://cli.github.com/manual/gh_pr_edit

출처

이 사본을 .agents/skills/ 아래에서 편집하십시오. 사전 커밋 훅이 이를 .claude/skills/로 미러링합니다. 미러를 직접 편집하지 마십시오.

GitHub PR 첨부 파일