claude-plugin-lab

GitHub 워크플로우 자동화를 위한 Claude Code 커스텀 슬래시 커맨드 모음.

워크플로우

5개의 커맨드가 하나의 파이프라인을 이룹니다:

plan-issue  →  code-gen  →  branch-commit  →  pull-request  →  merge
(이슈 생성)   (브랜치+코드)   (커밋/푸시)       (PR 생성)       (PR 병합)

각 단계를 완료하면 다음 커맨드를 자동으로 제안합니다.

요구사항

• Claude Code CLI
• Git
• GitHub CLI (gh) 설치
• gh로 GitHub 계정 인증 완료

이 플러그인의 주요 커맨드는 GitHub 이슈/PR 조회, 생성, 병합을 수행하므로 gh 인증이 필요합니다.

권한 설정 (선택)

이 플러그인은 git, gh 명령어를 자주 실행합니다. 매번 실행 허용 여부를 묻는 것이 번거롭다면, 프로젝트의 .claude/settings.json에 아래와 같이 권한을 미리 허용할 수 있습니다.

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(gh *)",
      "Read",
      "Glob",
      "Grep"
    ]
  }
}

이 설정은 선택사항입니다. 설정하지 않아도 각 명령 실행 시 개별적으로 허용할 수 있습니다.

gh 설치 및 인증 가이드

1단계: gh 설치

macOS(Homebrew)를 사용 중이라면:

brew install gh

다른 운영체제는 GitHub CLI 공식 사이트의 설치 가이드를 참고하세요.

2단계: GitHub 로그인

아래 명령어를 실행한 뒤 안내에 따라 로그인합니다.

gh auth login

보통 아래 조합을 선택하면 됩니다.

• GitHub.com
• HTTPS
• Login with a web browser

3단계: 인증 상태 확인

gh auth status

인증이 정상적으로 끝나면 이후 GitHub API를 사용하는 커맨드를 정상적으로 실행할 수 있습니다.

설치 (Marketplace를 통한 설치)

이 플러그인을 다른 프로젝트에서도 사용하려면 마켓플레이스를 추가한 뒤 플러그인을 설치합니다.

1단계: 마켓플레이스 추가

Claude Code 내에서 아래 명령어 중 하나를 실행합니다.

GitHub 축약형 (권장)

/plugin marketplace add leesumok/claude-plugin-lab

HTTPS

/plugin marketplace add https://github.com/leesumok/claude-plugin-lab.git

SSH

/plugin marketplace add git@github.com:leesumok/claude-plugin-lab.git

특정 브랜치나 태그를 지정하려면 #을 붙입니다:

/plugin marketplace add leesumok/claude-plugin-lab#v1.0.0

2단계: 플러그인 설치

마켓플레이스를 추가한 뒤, 플러그인을 설치합니다.

/plugin install claude-plugin-lab@claude-plugin-lab

또는 /plugin을 실행하여 Discover 탭에서 검색 후 설치할 수도 있습니다.

설치 범위를 선택할 수 있습니다:

• User scope: 모든 프로젝트에서 사용 (기본값)
• Project scope: 이 저장소의 모든 협력자가 사용
• Local scope: 이 저장소에서 나만 사용

3단계: 플러그인 로드

/reload-plugins

설치 후 아래와 같이 네임스페이스 커맨드를 사용할 수 있습니다:

/claude-plugin-lab:plan-issue 로그인 페이지 리디자인
/claude-plugin-lab:code-gen 42
/claude-plugin-lab:branch-commit
/claude-plugin-lab:pull-request
/claude-plugin-lab:merge 15

커맨드

이 저장소에서 직접 사용할 때는 /plan-issue처럼 네임스페이스 없이 사용할 수 있습니다. 다른 프로젝트에 플러그인으로 설치한 경우 /claude-plugin-lab:plan-issue 형식을 사용하세요.

/plan-issue <작업 주제>

작업 주제에 대한 계획을 수립하고 GitHub 이슈를 생성합니다.

/plan-issue 로그인 페이지 리디자인

/code-gen <이슈 번호>

이슈 번호를 기반으로 feature 브랜치를 생성하고, 작업계획에 따라 코드를 작성합니다.

/code-gen 42

완료 후 /branch-commit으로 이어서 진행할 수 있습니다.

/branch-commit [브랜치명] [커밋메시지]

브랜치를 생성하고 변경사항을 커밋/푸시합니다. 브랜치명을 생략하면 현재 브랜치에서 진행합니다.

/branch-commit
/branch-commit feat/login-redesign
/branch-commit feat/login-redesign "feat: redesign login page"

완료 후 /pull-request로 이어서 진행할 수 있습니다.

/pull-request [제목 | #이슈번호]

현재 브랜치에서 main으로 PR을 생성합니다.

/pull-request
/pull-request 로그인 페이지 리디자인
/pull-request #42

/merge <PR 번호>

PR을 squash merge하고 로컬을 정리합니다.

/merge 15