---
name: opencurrent-commit-pr-messages
description: "변경 내용을 읽고 커밋 메시지와 PR 설명을 에이전트가 쓰게 하면, 무엇을 왜 바꿨는지 정리하는 시간을 줄이고 리뷰어가 볼 곳도 분명해집니다. 이럴 때 사용: Claude Code에 변경을 커밋하고 PR을 만들어 달라고 하거나, commit-commands 플러그인의 /commit과 /commit-push-pr를 씁니다. 저장소 규칙(메시지 형식)은 CLAUDE.md에 적어 두고, 올리기 전에 내용을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code, GitHub CLI."
metadata:
  source: "https://opencurrent.ai/w/commit-pr-messages"
  opencurrent-id: "commit-pr-messages"
  verification: "pending"
  exported-at: "2026-11-21T11:04:45.281Z"
---

# 커밋 메시지와 PR 설명 맡기기

변경 내용을 읽고 커밋 메시지와 PR 설명을 에이전트가 쓰게 하면, 무엇을 왜 바꿨는지 정리하는 시간을 줄이고 리뷰어가 볼 곳도 분명해집니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/commit-pr-messages
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("commit-pr-messages")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

Claude Code에 변경을 커밋하고 PR을 만들어 달라고 하거나, commit-commands 플러그인의 /commit과 /commit-push-pr를 씁니다. 저장소 규칙(메시지 형식)은 CLAUDE.md에 적어 두고, 올리기 전에 내용을 확인합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

## 준비물

- Claude Code
- gh 설치와 로그인(PR을 만들 때)

## 단계

### 1. 메시지 규칙 적기 (사람이 · Claude Code)

커밋 메시지 형식을 CLAUDE.md에 한 줄로 적어 두면 매번 같은 형식으로 씁니다.

프롬프트:

```text
커밋 메시지: feat:/fix: + 한 줄 요약, 본문에 이유
```

기대 결과: CLAUDE.md의 메시지 규칙

확인 방법: CLAUDE.md에 규칙이 있는지 확인

### 2. 커밋 맡기기 (명령 실행 · Claude Code)

commit-commands 플러그인을 쓰면 /commit이 변경을 읽고 메시지를 써서 커밋합니다. .env 같은 비밀 파일은 커밋하지 않습니다.

프롬프트:

```text
/commit
```

기대 결과: 새 커밋

확인 방법: git log -1로 메시지 확인

### 3. PR 만들기 (AI에게 · Claude Code)

gh가 로그인돼 있으면 PR까지 만들게 할 수 있습니다. /commit-push-pr는 main이면 브랜치를 만들고 올린 뒤 gh pr create를 실행합니다.

프롬프트:

```text
이 변경으로 PR을 만들어 줘. 설명에는 무엇을, 왜 바꿨는지, 어떻게 확인했는지, 리뷰어가 볼 곳을 나눠 적어 줘.
```

기대 결과: PR과 설명

확인 방법: PR 설명이 실제 변경과 맞는지 확인

### 4. 나중에 그 세션 다시 열기 (명령 실행 · Claude Code)

Claude Code가 gh pr create로 만든 PR은 세션과 이어집니다. PR 번호로 그 대화를 다시 엽니다.

프롬프트:

```text
claude --from-pr 1234
```

기대 결과: PR을 만든 세션

확인 방법: 앞 대화가 이어지는지 확인

## 주의할 점

- 메시지가 그럴듯해도 변경을 잘못 요약할 수 있음. 올리기 전에 읽기
- PR 만들기에는 gh 설치와 로그인, origin 원격이 필요
- /commit은 Claude Code 표시를 커밋에 넣음. 원하지 않으면 메시지를 고치기

## 출처

- [Claude Code 문서: 자주 쓰는 작업(PR 만들기)](https://code.claude.com/docs/en/common-workflows)
- [commit-commands 플러그인](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/commit-commands)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/commit-pr-messages 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
