Github

• 에이전트가 대신 GitHub 이슈와 풀 리퀘스트를 모니터링하거나 분류하기를 원할 때.
• CI/CD 파이프라인 상태를 검사해야 할 때 — 워크플로우 실행 목록 조회, 실패한 단계 로그 확인, 또는 빌드 오류 진단.
• 다운스트림 처리나 보고를 위해 GitHub에서 구조화된 JSON 출력이 필요할 때.
• 표준 gh 서브커맨드가 제공하는 것 이상의 GitHub REST API 엔드포인트를 쿼리하고 싶을 때 (예: --jq 필터를 사용하여 특정 PR 필드 가져오기).

• Git 프로토콜 수준(클로닝, 커밋 푸시, 리베이스)에서 GitHub와 상호작용해야 하는 경우 — 이 스킬은 원시 Git 작업이 아닌 GitHub 플랫폼 API를 위한 것입니다.
• GitLab, Bitbucket 또는 기타 비-GitHub 호스트가 필요한 경우; gh CLI는 GitHub 전용입니다.

gh pr checks 및 gh pr list와 같은 명령어를 사용하여 pull request를 나열하고, 확인하고, 상태를 점검하세요. --repo owner/repo를 지정하면 git 디렉토리 외부에서도 항상 모든 저장소에 대해 작동합니다.

gh run list, gh run view, --log-failed를 사용하여 GitHub Actions 워크플로우 실행을 검사하고, 실패한 단계의 로그만 추출합니다. 수동으로 로그를 탐색하지 않고도 손상된 파이프라인을 진단해야 하는 에이전트에 이상적입니다.

gh api 명령어는 모든 GitHub REST API 엔드포인트에 접근할 수 있게 해줍니다. --jq 필터와 함께 사용하면 필요한 필드만 정확하게 추출할 수 있습니다 — 예를 들어, 한 번의 호출로 PR의 제목, 상태, 작성자를 가져올 수 있습니다.

대부분의 gh 하위 명령은 --json 플래그를 지원하므로 응답을 --jq 표현식으로 파이프하거나 다운스트림 도구에서 직접 사용할 수 있습니다. 이를 통해 에이전트가 Github 데이터를 프로그래밍 방식으로 파싱하고 처리하는 것이 간단해집니다.

gh issue list를 사용하여 이슈를 나열하고 필터링하며, 구조화된 쿼리를 위한 JSON 출력도 지원합니다. 표준 gh 플래그를 통해 레이블, 상태, 담당자 등으로 필터링할 수 있습니다.

에이전트가 모든 열린 PR을 확인하고, gh pr checks를 통해 CI 상태를 가져온 후, 실패하거나 멈춰 있는 PR을 찾아냅니다 — 개발자가 수동으로 대시보드를 확인하지 않아도 우선순위가 정해진 목록을 제공합니다.

빌드가 실패하면 에이전트가 gh run view <run-id> --log-failed를 실행하여 실패한 단계의 로그만 가져온 후 근본 원인을 요약합니다. 이를 통해 엔지니어들이 긴 CI 출력 결과를 일일이 스크롤하는 수고를 덜 수 있습니다.

에이전트는 gh issue list --json 및 --jq 필터를 사용하여 열린 이슈를 조회하고, 레이블·경과 기간·담당자별로 그룹화한 구조적인 보고서를 생성하여 주간 팀 요약본으로 활용합니다.

gh api와 커스텀 --jq 쿼리를 활용하여, 에이전트는 표준 서브커맨드로는 노출되지 않는 특정 메타데이터(예: PR 머지 커밋 SHA, 리뷰어 목록, 또는 워크플로우 타이밍)를 검색합니다.