tygwan GitHub CLI Skill
gh CLI를 활용한 GitHub 통합 관리 스킬입니다.
Pre-check: Target Repository
All gh commands use the current directory's git remote (origin).
Ensure it points to YOUR project repository, not the cc-initializer framework source.
# Verify current repo context
gh repo view --json nameWithOwner -q '.nameWithOwner'
Usage
/gh <command> [subcommand] [options]
Commands
Status & Dashboard
| Command | Description |
|---|---|
/gh status |
GitHub 상태 대시보드 (이슈, PR, 리뷰 요청, 멘션) |
/gh dashboard |
현재 repo 전체 현황 |
Issue Management
| Command | Description |
|---|---|
/gh issue list |
이슈 목록 |
/gh issue create |
새 이슈 생성 |
/gh issue view <n> |
이슈 상세 보기 |
/gh issue close <n> |
이슈 닫기 |
/gh issue develop <n> |
이슈에서 브랜치 생성 |
Pull Request
| Command | Description |
|---|---|
/gh pr list |
PR 목록 |
/gh pr create |
PR 생성 |
/gh pr view <n> |
PR 상세 |
/gh pr checks <n> |
PR CI 상태 |
/gh pr merge <n> |
PR 머지 |
/gh pr review <n> |
PR 리뷰 |
CI/CD (GitHub Actions)
| Command | Description |
|---|---|
/gh ci status |
최근 CI 실행 상태 |
/gh ci watch |
현재 실행 모니터링 |
/gh ci logs <id> |
실행 로그 보기 |
/gh ci rerun <id> |
실패한 실행 재시도 |
/gh workflow list |
워크플로우 목록 |
/gh workflow run <name> |
워크플로우 트리거 |
Release
| Command | Description |
|---|---|
/gh release list |
릴리스 목록 |
/gh release create <tag> |
릴리스 생성 |
/gh release view <tag> |
릴리스 상세 |
Search
| Command | Description |
|---|---|
/gh search issues <query> |
이슈 검색 |
/gh search prs <query> |
PR 검색 |
/gh search code <query> |
코드 검색 |
Quick Examples
1. 상태 확인
/gh status
Output:
## GitHub Status Dashboard
### Assigned to You
- #123 Fix login bug (myorg/app)
- #456 Add dark mode (myorg/app)
### Review Requests
- PR #789 feat: add auth (waiting for your review)
### Recent CI
- ✅ CI passed (3m ago)
- ✅ Deploy completed (10m ago)
2. 이슈 기반 개발 시작
/gh issue develop 123
Actions:
- 이슈 #123 확인
feature/123-fix-login-bug브랜치 생성- 브랜치 체크아웃
- 이슈와 브랜치 연결
3. PR 생성 + CI 모니터링
/gh pr create
/gh pr checks --watch
Actions:
- 현재 브랜치에서 PR 생성
- CI 실행 실시간 모니터링
- 완료 시 결과 알림
4. CI 실패 분석
/gh ci logs --failed
Output:
## CI Failure Analysis
**Job**: test
**Error**:
FAIL src/auth.test.ts ✕ should authenticate user (15ms) Expected: 200 Received: 401
**Suggestion**: Check mock authentication setup
5. 릴리스 생성
/gh release create v1.2.0
Actions:
- 최근 커밋 분석
- 릴리스 노트 자동 생성
- 태그 생성
- GitHub Release 발행
Integration with cc-initializer
Sprint → Issue
/gh issue create --from-sprint
Sprint TASKS에서 이슈 자동 생성:
- 라벨:
sprint:N - 마일스톤 연결
- 담당자 할당
Phase → Milestone
/gh milestone create --from-phase
Phase를 GitHub Milestone으로 변환
TODO → Issue
/gh issue create --from-todo
코드의 TODO 주석을 이슈로 변환
Release Workflow
/gh release create --with-changelog
- CHANGELOG.md 분석
- 시맨틱 버전 계산
- 릴리스 노트 생성
- GitHub Release 발행
Configuration
.claude/settings.json:
{
"github": {
"default_base_branch": "main",
"pr_template": ".github/PULL_REQUEST_TEMPLATE.md",
"auto_assign_reviewers": true,
"ci_watch_timeout": 600,
"release_generate_notes": true
}
}
Prerequisites
gh CLI 설치 확인
gh --version
gh auth status
인증 안 된 경우
gh auth login --web
Command Reference
Issue Commands
# 목록
gh issue list [--state open|closed|all] [--label <label>] [--assignee @me]
# 생성
gh issue create --title "Title" --body "Body" [--label bug] [--assignee @me]
# 보기
gh issue view <number> [--web] [--json fields]
# 브랜치 생성
gh issue develop <number> [--checkout] [--name <branch-name>]
# 닫기
gh issue close <number> [--reason completed|"not planned"]
# 코멘트
gh issue comment <number> --body "Comment"
PR Commands
# 목록
gh pr list [--state open|closed|merged|all] [--author @me]
# 생성
gh pr create --title "Title" --body "Body" [--draft] [--reviewer user1]
# 보기
gh pr view <number> [--web] [--json fields]
# CI 상태
gh pr checks <number> [--watch]
# 리뷰
gh pr review <number> --approve|--request-changes|--comment [--body "Comment"]
# 머지
gh pr merge <number> [--squash|--rebase] [--auto] [--delete-branch]
CI Commands
# 실행 목록
gh run list [--workflow <name>] [--branch <branch>] [--status failure]
# 실행 보기
gh run view <run-id> [--log] [--log-failed] [--web]
# 실시간 모니터링
gh run watch [<run-id>]
# 재실행
gh run rerun <run-id> [--failed]
# 워크플로우 트리거
gh workflow run <workflow> [--ref <branch>] [-f key=value]
Release Commands
# 목록
gh release list [--limit N]
# 생성
gh release create <tag> [files...] --title "Title" --notes "Notes" [--draft] [--prerelease] [--generate-notes]
# 보기
gh release view <tag> [--web]
# 다운로드
gh release download <tag> [--pattern "*.zip"]
Related
- Agent:
github-manager- 상세 GitHub 작업 - Agent:
pr-creator- PR 생성 전문 - Agent:
branch-manager- 브랜치 관리 - Command:
/release- 릴리스 워크플로우