Claude Code Skills로 PR 워크플로우 자동화하기

Claude Code의 Skills(커스텀 슬래시 명령어)를 활용하여 PR 생성, 리뷰 분석, 답글 작성까지의 워크플로우를 자동화한 경험을 정리합니다.

2026.03.23 ·

claude-code skills automation dx

Claude Code Skills란

Claude Code에는 Skills라는 기능이 있다. 프로젝트의 .claude/commands/ 폴더에 마크다운 파일을 작성하면, 그것이 곧 슬래시 명령어(/command-name)가 된다.

.claude/commands/
├── create-pr.md      → /create-pr
├── review-pr.md      → /review-pr
└── reply-review.md   → /reply-review

파일 이름이 곧 명령어 이름이다. /create-pr을 입력하면 create-pr.md에 정의된 프롬프트가 실행된다.

핵심은 프롬프트를 코드처럼 관리할 수 있다는 점이다. Git으로 버전 관리되고, 팀원과 공유할 수 있고, PR을 통해 개선할 수 있다.

왜 필요한가

PR 관련 작업에는 반복적인 패턴이 있다.

PR 생성 시:

커밋 히스토리를 확인하고
변경 파일을 분석하고
템플릿에 맞춰 본문을 작성하고
적절한 라벨을 선택한다

리뷰 대응 시:

리뷰 코멘트를 하나씩 읽고
해당 코드의 맥락을 파악하고
동의할지, 반박할지 판단하고
근거를 정리해서 답글을 작성한다

매번 같은 흐름인데, 매번 처음부터 수작업으로 한다. Claude Code에 자연어로 요청할 수도 있지만, 그러면 매번 원하는 형식과 절차를 다시 설명해야 한다. Skills는 이 반복되는 프롬프트를 파일로 고정하는 것이다.

실제 사용 중인 Skills

이 포트폴리오 프로젝트에서 PR 워크플로우 전체를 3개의 Skills로 구성했다.

/create-pr — PR 생성 자동화

/create-pr feature/0.7.0

이 명령어 하나로 다음이 자동으로 진행된다.

현재 브랜치와 base 브랜치 사이의 커밋 히스토리 분석
변경된 파일 목록 확인
.github/PULL_REQUEST_TEMPLATE.md 형식에 맞춘 PR 본문 작성
커밋 내용 기반으로 적절한 GitHub Label 자동 결정
gh pr create 실행

Skills 파일에는 PR 제목 규칙, 본문 규칙, 라벨 매핑 테이블까지 정의되어 있다. 예를 들어 라벨 매핑은 이렇게 작성했다.

| 작업 유형                  | Label           |
| -------------------------- | --------------- |
| ✨ 새 기능 (New Feature)   | `feature`       |
| 🐛 버그 수정 (Bug Fix)     | `bug`           |
| 🔧 리팩토링 (Refactoring)  | `refactor`      |
| 🚀 성능 개선 (Performance) | `performance`   |
| 📝 문서 (Documentation)    | `documentation` |

이 테이블이 Skills 파일에 포함되어 있으므로, Claude Code가 커밋 히스토리를 분석한 후 자동으로 맞는 라벨을 선택한다.

/review-pr — 리뷰 코멘트 분석

/review-pr 42

PR에 달린 코드 리뷰 코멘트를 분석하고, 각 코멘트를 세 가지로 분류한다.

동의 — 리뷰어 의견이 타당하며 수정이 필요한 경우
검토 필요 — 일부 동의하지만 방향에 대해 논의가 필요한 경우
반박 — 리뷰어 의견이 프로젝트 규칙이나 버전과 맞지 않는 경우

중요한 점은, 리뷰 코멘트가 참조하는 코드를 직접 읽고 맥락을 파악한 뒤 의견을 제시하도록 절차를 정의했다는 것이다. 코멘트 텍스트만 보고 판단하는 것이 아니라, 실제 코드 상태까지 확인한다.

Skills 파일에 이런 주의사항도 포함된다.

## 주의사항

- 리뷰어의 의견이 맞더라도 프로젝트의 CLAUDE.md 규칙과 충돌하는 경우,
  프로젝트 규칙을 우선한다.
- 코드를 바로 수정하지 않는다. 수정 방안만 제안하고,
  사용자가 요청할 때 수정한다.

이렇게 하면 AI 코드 리뷰어가 남긴 코멘트가 프로젝트 설정과 맞지 않을 때(예: 사용 중인 프레임워크 버전에서 지원하지 않는 기능을 제안하는 경우), 자동으로 반박 근거를 찾아준다.

/reply-review — 리뷰 답글 작성

/reply-review 42

/review-pr의 분석 결과를 기반으로 GitHub에 실제 답글을 작성한다. 이 명령어에는 몇 가지 규칙이 설계되어 있다.

동의 항목에는 답글을 남기지 않는다. 코드 수정으로 대응하면 충분하기 때문이다.

반박 항목에는 근거와 함께 답글을 작성한다.

@{리뷰어} {반박/대안 설명}

**근거:**

- {구체적 근거 1}
- {구체적 근거 2}

검토 필요 항목은 사용자에게 방향을 먼저 확인한다. 리뷰어 의견대로 진행하기로 했으면 답글을 남기지 않고, 다른 방향으로 결정했을 때만 답글을 작성한다.

이 세 가지 규칙 덕분에 불필요한 코멘트 없이 의미 있는 답글만 남게 된다.

Skills 작성법

Skills 파일은 일반 마크다운이다. 정해진 형식은 없지만, 실제로 사용하면서 효과적이었던 구조를 공유한다.

기본 구조

{한 줄 설명}

## 입력

- 파라미터: $ARGUMENTS (인자 설명)

## 실행 절차

1. 첫 번째 단계
2. 두 번째 단계
3. ...

## 출력 형식

{결과를 어떤 포맷으로 보여줄지}

## 주의사항

- 하지 말아야 할 것
- 반드시 지켜야 할 것

작성 팁

$ARGUMENTS로 인자를 받는다. /create-pr feature/0.7.0에서 feature/0.7.0이 $ARGUMENTS에 들어간다. 인자가 없을 때의 fallback 동작도 명시해두면 좋다.

실행 절차는 구체적으로 작성한다. “PR을 분석한다”보다 “커밋 히스토리를 조회한다 (git log {base}..HEAD --oneline)“가 더 일관된 결과를 만든다. 어떤 CLI 명령을 사용할지까지 명시하면 실행 흐름이 안정적이다.

주의사항은 경험에서 나온다. 처음부터 완벽한 Skills를 만들 필요는 없다. 사용하면서 “이건 안 했으면 좋겠는데”라는 순간이 오면, 그때 주의사항에 추가하면 된다.

사용하면 뭐가 좋은가

일관된 PR 품질

PR 본문의 형식이 매번 동일하다. 템플릿을 사용하더라도 사람이 작성하면 상세도가 들쭉날쭉해지는데, Skills가 커밋 히스토리와 변경 파일을 기반으로 작성하므로 누락이 줄어든다.

리뷰 대응 시간 단축

10개의 리뷰 코멘트가 달렸을 때, 각각의 코멘트가 참조하는 코드를 열어보고 맥락을 파악하는 시간이 상당하다. /review-pr이 이 과정을 대신하고, 동의/반박을 분류해주므로 개발자는 판단에만 집중할 수 있다.

워크플로우 표준화

Skills 파일이 Git에 커밋되어 있으므로, 팀 프로젝트라면 모든 팀원이 같은 PR 워크플로우를 사용하게 된다. 새로운 팀원이 합류해도 /create-pr만 실행하면 프로젝트의 PR 규칙을 자동으로 따르게 된다.

점진적 개선

Skills는 마크다운 파일이므로 수정이 쉽다. “리뷰 답글에 리뷰어 멘션이 빠져 있었다”라는 피드백이 있으면, reply-review.md에 한 줄 추가하면 된다. 프롬프트의 버전 관리가 가능하다는 것은, 프롬프트를 계속 개선할 수 있다는 뜻이다.

정리

항목	내용
Skills란	`.claude/commands/`에 마크다운으로 정의하는 커스텀 슬래시 명령어
핵심 가치	반복되는 프롬프트를 코드처럼 관리하고 공유할 수 있음
적합한 용도	절차가 정해져 있고, 일관된 출력이 필요한 반복 작업
작성 방법	입력 → 실행 절차 → 출력 형식 → 주의사항 구조

Skills의 본질은 결국 프롬프트 엔지니어링을 파일로 고정하는 것이다. 좋은 프롬프트를 한 번 만들어두면 매번 같은 품질의 결과를 얻을 수 있고, 피드백이 생기면 파일을 수정하면 된다. 코드를 리팩토링하듯 프롬프트도 점진적으로 개선할 수 있다는 점이 가장 큰 장점이다.