isamisushi/glab-skill

glab-skill은(는) 무엇을 하나요?

glab CLI를 통해 GitLab 작업을 수행하는 재사용 가능한 AI 에이전트 스킬입니다. 체크인된 명령어 참조와 추론을 금지하는 엄격한 워크플로우를 제공합니다.

개요

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 GitLab API에 액세스할 때 glab CLI 도구를 사용하도록 안내합니다. 명령어 추측을 방지하고, 저장소 내에 문서화된 실제 명령어 예제를 사용하도록 강제합니다.

필수 조건

• glab CLI가 설치되어 있어야 함
• glab auth login을 통해 GitLab 인증이 완료되어야 함
• glab CLI 버전: 1.45.0 이상 권장

설치

1. glab 설치:

   • macOS: brew install glab
   • Linux: snap install glab 또는 apt install glab
   • Windows: scoop install glab 또는 Chocolatey

2. 인증:

glab auth login

사용법

프로젝트 작업

# 현재 프로젝트 정보 보기
glab project view

# 이슈 목록 보기
glab issue list

# 새 이슈 생성
glab issue create --title "버그 수정" --description "상세 설명"

# Merge Request 목록 보기
glab mr list

# Merge Request 생성
glab mr create --source-branch feature-branch --target-branch main --title "MR 제목"

# Merge Request 승인
glab mr approve <mr-id>

파이프라인 작업

# 파이프라인 목록 보기
glab ci list

# 파이프라인 상세 보기
glab ci view <pipeline-id>

# 특정 파이프라인의 작업 로그 보기
glab ci job logs <job-id>

릴리스 작업

# 릴리스 목록 보기
glab release list

# 새 릴리스 생성
glab release create v1.0.0 --name "v1.0.0" --notes "릴리스 노트"

환경 변수

# 환경 변수 목록 보기
glab variable list

# 환경 변수 설정
glab variable set KEY value

워크플로우 규칙

1. 에이전트는 명령어를 추측하지 말 것
2. 항상 이 문서 또는 저장소 내 다른 문서에 명시된 명령어만 사용할 것
3. 필요 시 glab --help를 사용하여 추가 명령어 정보를 확인할 것
4. 명령어 실행 전에 필요한 인자와 플래그를 정확히 확인할 것

참고

• 공식 glab 문서: https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source
• glab CLI 저장소: https://gitlab.com/gitlab-org/cli