GitHub은(는) 무엇을 하나요?
GitHub 작업에는 gh를 사용합니다. 로컬 커밋/브랜치/푸시/풀에는 git을 사용합니다. 심층 리뷰에는 코드 읽기 도구를 사용하세요.
인증
gh auth status
gh auth login
게이트웨이의 HOME은 운영자 HOME과 다를 수 있습니다. 다른 곳에 gh 인증이 있는 경우, 게이트웨이 서비스 환경에 GH_CONFIG_DIR을 설정하고 재시작하세요.
PR
gh pr list --repo owner/repo --json number,title,state,author,url
gh pr view 55 --repo owner/repo --json title,body,author,files,commits,reviews,reviewDecision
gh pr checks 55 --repo owner/repo
gh pr diff 55 --repo owner/repo
gh pr create --repo owner/repo --title "feat: title" --body-file /tmp/pr.md
PR 본문을 생성하거나 새로 고칠 때, Runtime 라인이 sessionUrl=<정확한-url>을 제공하는 경우에만 이 최종 푸터를 추가하세요. <sessionUrl>을 해당 URL로 그대로 대체하고, 구성하거나 수정하지 마세요. sessionUrl은 명시적으로 공개된 세션에 대해서만 제공됩니다. 없으면 푸터를 생략하고, 비공개 채팅 URL을 대체하거나 공유를 활성화하여 얻지 마세요. 정확히 하나의 푸터 앞에 있는 게시 마커를 유지하고 푸터를 마지막에 두세요.
---
[OpenClaw 팀 세션 보기](https://raw.githubusercontent.com/clawdbot/clawdbot/main/<sessionUrl>)
URL은 직접 작동합니다: gh pr view https://github.com/owner/repo/pull/55.
비동기 병합
제공되는 경우 리포지토리의 기본 랜딩 워크플로우를 사용하세요. 다른 곳에서 승인된 프로그래밍 방식 병합의 경우, GitHub의 비동기 병합 API를 gh api를 통해 사용하세요. gh pr merge는 이 API를 선택하지 않습니다. 리뷰된 헤드 SHA를 제공하고, 필요한 리뷰/체크를 유지하며, 먼저 스택 멤버십을 확인하세요: 스택된 PR을 제출하면 열려 있는 다운스택 PR도 병합되거나 대기열에 추가되며, 이는 자체 리뷰와 승인이 필요합니다.
gh api -H 'X-Octopool-Require: merge-async-v1' \
--method PUT repos/owner/repo/pulls/55/merge-async \
-H 'X-GitHub-Api-Version: 2026-03-10' \
-f sha=REVIEWED_HEAD_SHA -f merge_method=squash -f merge_action=direct_merge
gh api -H 'X-Octopool-Require: merge-async-v1' \
repos/owner/repo/pulls/55/merge-async/REQUEST_UUID \
-H 'X-GitHub-Api-Version: 2026-03-10' -H 'Cache-Control: max-age=0'
Octopool 가드 헤더를 api 다음에 먼저 두세요. 보호된 이전 래퍼는 병합 권한을 다시 작성하기 전에 이를 거부합니다. 거부되는 경우 비동기 가드가 포함된 Octopool 빌드를 사용하세요. 지원되는 래퍼는 SHA/메서드/작업/우회를 유지하고 커밋 텍스트만 다시 작성합니다. 네이티브 gh는 헤더를 전달할 수 있습니다. 거부를 해결하기 위해 이를 제거하거나, 정책을 비활성화하거나, 원시 바이너리를 선택하지 마세요.
폴링하기 전에 202 응답에서 details.uuid를 보관하세요. pending은 대기를 의미합니다. merged에는 details.sha가 포함되며, 이는 최종 PR/헤드 확인이 여전히 필요합니다. enqueued는 대기열에 추가되었음을 의미하며 병합된 것이 아닙니다. PR 자체를 모니터링하세요. 구성된 대기열을 적용하려면 merge_action=default(또는 명시적으로 대기열에 추가하려면 merge_queue)를 사용하고, 직접 전용 메서드/제목/메시지 필드는 생략하세요. 승인 없이 bypass_rules를 활성화하지 마세요.
failed 시 details.message를 보고하세요. 409는 기존 요청을 식별합니다. 재제출하지 않고 UUID와 옵션을 검사하세요. 손실된 응답, 폴링 오류 및 24시간 후 결과 만료는 블라인드 재시도나 동기식 폴백이 아닌 조정이 필요합니다. 제한된 대기와 새로 읽기로 폴링하세요. 비동기 처리는 충족되지 않은 검사에 대해 자동 병합을 활성화하지 않습니다. 해당 동작이 승인된 경우 기본 워크플로우나 gh pr merge --auto를 사용하세요.
랜딩 소유권
사용자가 PR을 랜딩하거나 병합하도록 요청하면, 최종 결과는 리뷰, 작업자 턴 또는 CI 관찰의 끝이 아니라 PR의 확인된 GitHub 상태입니다.
gh pr view ... --json state,mergedAt,mergeCommit이state가MERGED임을 증명할 때까지 작업을 활성 상태로 유지하세요.- 리뷰 결과, 병합 충돌, 실패한 검사 및 요청된 변경 사항이 범위 내에 있는 경우 계속 작업으로 처리하세요. 패치하고, 필요한 게이트를 재실행하며, 정확히 업데이트된 헤드를 재평가하세요.
- 보류 중인 검사는 완료가 아닌 대기 상태입니다. 리포지토리에서 지원하는 대기 또는 병합 워크플로우를 사용하고, 부분적인 녹색 검사로 성공을 주장하지 마세요.
- 지속 세션에 작업이 위임되었고 해당 실행이 병합 전에 중지된 경우, 보고서를 최종 결과로 처리하지 말고 동일한 세션을 계속하세요.
- 계속하기 위해 새로운 권한, 사용할 수 없는 자격 증명 또는 안전하게 추론할 수 없는 제품 결정이 필요한 경우에만 차단된 것으로 중지하세요. 정확한 차단 요소를 보고하고 PR을 병합되지 않은 상태로 두세요.
이슈
gh issue list --repo owner/repo --state open --json number,title,labels,url
gh issue view 42 --repo owner/repo --json title,body,comments,labels,state
gh issue create --repo owner/repo --title "Bug: ..." --body-file /tmp/issue.md
gh issue comment 42 --repo owner/repo --body-file /tmp/comment.md
gh issue close 42 --repo owner/repo --comment "Fixed in ..."
CI/실행
gh run list --repo owner/repo --limit 10
gh run view <run-id> --repo owner/repo --json status,conclusion,headSha,url
gh run view <run-id> --repo owner/repo --log-failed
gh run rerun <run-id> --repo owner/repo --failed
API
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
gh api repos/owner/repo/labels --jq '.[].name'
gh api --cache 1h repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'
구조화된 출력을 위해 --json + --jq를 사용하세요. 백틱, 셸 스니펫, 환경 변수 이름 또는 사용자 텍스트가 포함된 댓글/본문에는 --body-file을 사용하세요.