메뉴
GitHub GraphQL API 가이드. GraphQL 쿼리 작성, Rate Limit 처리, User/ContributionsCollection 조회, 페이지네이션 등. GitHub API, GraphQL, contributionsCollection 키워드 또는 GitHub API 관련 코드 작업 시 자동 로드.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | github-graphql |
| description | GitHub GraphQL API 가이드. GraphQL 쿼리 작성, Rate Limit 처리, User/ContributionsCollection 조회, 페이지네이션 등. GitHub API, GraphQL, contributionsCollection 키워드 또는 GitHub API 관련 코드 작업 시 자동 로드. |
GitHub GraphQL API를 사용한 데이터 조회 및 조작을 위한 참조 문서입니다.
POST https://api.github.com/graphql
curl -H "Authorization: Bearer {TOKEN}" \
-X POST \
-d '{"query": "query { viewer { login }}"}' \
https://api.github.com/graphql
| 인증 방식 | 제한 |
|---|---|
| Personal Access Token | 시간당 5,000 포인트 |
| GitHub App (Enterprise Cloud) | 시간당 10,000 포인트 |
| GitHub Actions GITHUB_TOKEN | 리포지토리당 시간당 1,000 포인트 |
상태 확인 헤더:
x-ratelimit-remaining: 잔여 포인트x-ratelimit-reset: 재설정 시간 (Unix timestamp)query($username: String!) {
user(login: $username) {
contributionsCollection {
totalCommitContributions
totalIssueContributions
totalPullRequestContributions
totalPullRequestReviewContributions
}
}
}
query {
rateLimit {
limit
remaining
used
resetAt
}
}
query($owner: String!, $name: String!) {
repository(owner: $owner, name: $name) {
issues(first: 100, after: $cursor) {
nodes { title }
pageInfo {
endCursor
hasNextPage
}
}
}
}
| 문서 | 설명 |
|---|---|
| GraphQL 소개 | 기본 개념, 스키마, 필드, Connection |
| 호출 형성 | 인증, 쿼리/뮤테이션 작성법, 변수 사용 |
| Rate Limits | 속도 제한, 포인트 계산, 최적화 전략 |
| 쿼리 참조 | 루트 쿼리 목록 (user, repository 등) |
| User/ContributionsCollection | 사용자 기여 데이터 조회 |
| 페이지네이션 | 커서 기반 페이지 매김 |
| 전역 노드 ID | REST ↔ GraphQL 간 ID 활용 |
GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.
GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다.
변경사항 커밋/푸시 워크플로우 자동화. 이슈 생성, 브랜치 생성, 원자적 커밋, 검증, push, PR 생성 후 CI 폴링/실패 복구까지 한 번에 진행해 달라는 명시적 요청에서 사용한다.
버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다.
구현 계획 문서를 6가지 관점으로 순차 리뷰하고, 수동 텍스트 승인 루프로 의견/승인을 받아 즉시 반영한 뒤 반복 루프를 수행한다.
GitHub 이슈 URL을 인자로 받아 이슈 정보를 확인하고 git worktree 기반 작업 브랜치를 생성한 뒤 이슈 계획 문서를 만든다. 이슈 URL 기준으로 브랜치/worktree/계획 문서 초기화를 요청할 때 사용한다.