Skip to content

[FEAT] Claude PR 자동화 스킬 설계 및 구현 계획 문서 작성#65

Closed
codrin2 wants to merge 3 commits intodevelopfrom
codrin2/create-pr-skills
Closed

[FEAT] Claude PR 자동화 스킬 설계 및 구현 계획 문서 작성#65
codrin2 wants to merge 3 commits intodevelopfrom
codrin2/create-pr-skills

Conversation

@codrin2
Copy link
Member

@codrin2 codrin2 commented Feb 15, 2026

Issue Number

DH-6

As-Is

1. 기존 동작 및 문제 상황

  • PR 작성 시 매번 수동으로 브랜치 생성, 커밋 정리, PR 템플릿 작성 필요
  • 릴리즈 PR 작성 시 변경사항 분류 및 버전 결정을 수작업으로 진행

2. 대안 분석 (각 접근 방식의 장단점)

  • 단일 통합 스킬: 하나의 스킬로 모든 PR 처리 / 책임 과부하, CSO 검색 어려움
  • 3개 분리 스킬 (start, finish, release): 최대 단일 책임 / start-finish 연결성 상실
  • 2개 스킬 (feature-pr + release-pr): 라이프사이클 유지 + 릴리즈 분리 / 균형 잡힌 설계

To-Be

1. 최종 구현 결과

  • feature-pr 스킬: start/finish 2단계 라이프사이클 (브랜치 생성 → PR 작성)
  • release-pr 스킬: develop → main 릴리즈 PR (변경사항 분류 + 버전 제안 + 2단계 확인 게이트)
  • 설계 문서 및 구현 계획 문서 작성 완료

2. 기존 대비 변경 내역

  • (없음) → 설계 문서 docs/plans/2026-02-15-pr-skills-design.md 추가
  • (없음) → 구현 계획 문서 docs/plans/2026-02-15-pr-skills-impl-plan.md 추가
  • (없음) → ~/.claude/skills/feature-pr/SKILL.md 스킬 파일 생성
  • (없음) → ~/.claude/skills/release-pr/SKILL.md 스킬 파일 생성

3. 미해결 이슈 및 향후 검토 사항

  • 스킬 파일은 ~/.claude/skills/에 위치하여 repo에 포함되지 않음 (개인 설정)
  • 새 Claude Code 세션에서 스킬 인식 여부 실제 테스트 필요
  • GitHub 라벨 (🚀 FEAT, 🚨 FIX, 🔋 REFACTOR) 사전 생성 필요 여부 확인

✅ Check List

  • Have all tests passed?
  • Have all commits been pushed?
  • Did you verify the target branch for the merge?
  • Did you assign the appropriate assignee(s)?
  • Did you set the correct label(s)?

📸 Test Screenshot

Additional Description

스킬 파일(~/.claude/skills/)은 개인 로컬 환경에 생성되며, 이 PR에는 설계/계획 문서만 포함됩니다.

Summary by CodeRabbit

릴리스 노트

  • 문서
    • PR 워크플로우 관리를 위한 두 가지 스킬에 대한 설계 및 구현 계획 문서 추가
    • feature-pr: 기능 브랜치 생성 및 관리를 위한 구조화된 워크플로우 정의
    • release-pr: 개발 버전에서 메인으로의 자동 릴리즈 PR 생성 프로세스 문서화

codrin2 and others added 3 commits February 15, 2026 21:51
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@codrin2 codrin2 self-assigned this Feb 15, 2026
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 15, 2026

개요

두 개의 새로운 설계 및 구현 계획 문서가 docs/plans 디렉토리에 추가됩니다. feature-pr과 release-pr이라는 두 Claude 기술에 대한 설계 사양 및 구현 지침을 포함합니다.

변경사항

그룹 / 파일 요약
PR 기술 설계 및 구현 계획
docs/plans/2026-02-15-pr-skills-design.md, docs/plans/2026-02-15-pr-skills-impl-plan.md
feature-pr과 release-pr 기술에 대한 설계 문서와 구현 계획을 추가합니다. 설계 문서는 두 기술의 라이프사이클, 브랜치 명명 규칙, 자동화된 검사, PR 바디 템플릿을 정의합니다. 구현 계획은 SKILL.md 템플릿, 검증 단계, 수동 테스트 워크플로우를 제공합니다.

예상 코드 리뷰 노력

🎯 2 (Simple) | ⏱️ ~12분

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed PR 제목이 핵심 변경사항인 'Claude PR 자동화 스킬 설계 및 구현 계획 문서 작성'을 명확하게 요약하고 있습니다.
Description check ✅ Passed PR 설명이 제목, As-Is/To-Be, 체크리스트, 추가 설명 등 요구되는 대부분의 섹션을 포함하고 있으며 충분히 상세합니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into develop

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch codrin2/create-pr-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🤖 Fix all issues with AI agents
In `@docs/plans/2026-02-15-pr-skills-design.md`:
- Around line 36-69: The fenced code block in the PR template is missing a
language identifier which triggers lint warnings; update the opening ``` to
include a language (e.g., ```markdown or ```md) for the block in
docs/plans/2026-02-15-pr-skills-design.md so the linter recognizes the language
and the warning is resolved—locate the triple-backtick block that wraps the
template and change the delimiter to include the language identifier.
- Around line 13-18: 문서의 헤딩 레벨이 건너뛰어 한 단계씩 증가하지 않으므로 "Skill 1: `feature-pr`"와 하위
제목 "Start Phase (`/feature-pr start`)" 등 모든 헤더를 한 단계씩만 증가하도록 재조정하세요; 예를 들어 최상위
개요 다음은 H2, 그 하위는 H3로 맞추고 현재 H1→H3 같은 점프가 있는 곳을 찾아 각 헤더 토큰을 하나 레벨 낮추거나 올려 계층을
연속적으로 수정해 구조를 일관되게 만드세요.
- Around line 128-134: The fenced code block showing the directory tree
(~/.claude/skills/ with feature-pr/ and release-pr/ containing SKILL.md) lacks a
language identifier and triggers a lint warning; update that code block by
adding an appropriate language tag (e.g., ```bash or ```text) immediately after
the opening backticks so the linter recognizes the block type and the warning is
resolved.

In `@docs/plans/2026-02-15-pr-skills-impl-plan.md`:
- Around line 13-17: 문서의 헤딩 레벨이 건너뛰어져 있으므로 "Task 1: Create skills directory
structure" 같은 상위 헤딩부터 각 하위 섹션이 한 단계씩만 내려가도록 조정하세요; 즉 현재 한 단계 이상 건너뛴 헤딩들을 찾아서 모두
하나씩 올리거나(예: ### -> ####) 내려서(예: ## -> ###) 연속적인 레벨 흐름을 만들고, 목록에 있는 SKILL.md
플레이스홀더 항목들도 그에 맞춰 헤딩 레벨을 맞춰 정렬하세요.
- Around line 61-94: The fenced code block starting with ``` before the "##
Issue Number" section has no language identifier causing lint warnings; fix it
by changing the opening fence to include a language (e.g., add "markdown" or
"md" after the opening ```), and apply the same change to any other anonymous
fenced blocks in the document to remove the lint warning (locate the block by
the opening ``` and the "## Issue Number" header).
- Around line 138-149: The fenced code block that begins with ``` before the "##
Summary" section lacks a language identifier, causing lint warnings; change the
opening fence from ``` to ```markdown (or ```md) to mark the block as Markdown
so the linter recognizes it, and similarly add language identifiers to any other
untyped fenced blocks in the same file (look for the triple-backtick fences
surrounding "## Summary", "### Major Changes", etc.).

Comment on lines +13 to +18

## Skill 1: `feature-pr`

Lifecycle skill with two phases, invoked via args.

### Start Phase (`/feature-pr start`)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

헤딩 레벨 점프를 정리하세요.

헤딩 레벨이 한 단계씩만 증가하도록 구조를 맞춰 주세요.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 13-13: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-design.md` around lines 13 - 18, 문서의 헤딩 레벨이
건너뛰어 한 단계씩 증가하지 않으므로 "Skill 1: `feature-pr`"와 하위 제목 "Start Phase (`/feature-pr
start`)" 등 모든 헤더를 한 단계씩만 증가하도록 재조정하세요; 예를 들어 최상위 개요 다음은 H2, 그 하위는 H3로 맞추고 현재
H1→H3 같은 점프가 있는 곳을 찾아 각 헤더 토큰을 하나 레벨 낮추거나 올려 계층을 연속적으로 수정해 구조를 일관되게 만드세요.

Comment on lines +36 to +69
```
## Issue Number
DH-{id}

## As-Is
### 1. 기존 동작 및 문제 상황
- {기존에 어떤 동작/상태였는지}
- {어떤 문제가 발생했는지}

### 2. 대안 분석 (각 접근 방식의 장단점)
- {방식 A}: {장점} / {단점}
- {방식 B}: {장점} / {단점}

## To-Be
### 1. 최종 구현 결과
- {구현된 핵심 내용}

### 2. 기존 대비 변경 내역
- {변경 전} → {변경 후}

### 3. 미해결 이슈 및 향후 검토 사항
- {남은 이슈 또는 추가 검토 필요 사항}

## Check List
- [x] Have all tests passed?
- [x] Have all commits been pushed?
- [x] Did you verify the target branch for the merge?
- [ ] Did you assign the appropriate assignee(s)?
- [ ] Did you set the correct label(s)?

## Test Screenshot

## Additional Description
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

코드 블록에 언어 식별자를 추가하세요.

fenced code block에 언어가 지정되지 않아 lint 경고가 발생합니다.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 61-61: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-design.md` around lines 36 - 69, The fenced
code block in the PR template is missing a language identifier which triggers
lint warnings; update the opening ``` to include a language (e.g., ```markdown
or ```md) for the block in docs/plans/2026-02-15-pr-skills-design.md so the
linter recognizes the language and the warning is resolved—locate the
triple-backtick block that wraps the template and change the delimiter to
include the language identifier.

Comment on lines +128 to +134
```
~/.claude/skills/
feature-pr/
SKILL.md
release-pr/
SKILL.md
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

코드 블록에 언어 식별자를 추가하세요.

fenced code block에 언어가 지정되지 않아 lint 경고가 발생합니다.

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-design.md` around lines 128 - 134, The fenced
code block showing the directory tree (~/.claude/skills/ with feature-pr/ and
release-pr/ containing SKILL.md) lacks a language identifier and triggers a lint
warning; update that code block by adding an appropriate language tag (e.g.,
```bash or ```text) immediately after the opening backticks so the linter
recognizes the block type and the warning is resolved.

Comment on lines +13 to +17
### Task 1: Create skills directory structure

**Files:**
- Create: `~/.claude/skills/feature-pr/SKILL.md` (placeholder)
- Create: `~/.claude/skills/release-pr/SKILL.md` (placeholder)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

헤딩 레벨 점프를 정리하세요.

헤딩 레벨이 한 단계씩만 증가하도록 구조를 맞춰 주세요.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 13-13: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-impl-plan.md` around lines 13 - 17, 문서의 헤딩
레벨이 건너뛰어져 있으므로 "Task 1: Create skills directory structure" 같은 상위 헤딩부터 각 하위 섹션이 한
단계씩만 내려가도록 조정하세요; 즉 현재 한 단계 이상 건너뛴 헤딩들을 찾아서 모두 하나씩 올리거나(예: ### -> ####) 내려서(예:
## -> ###) 연속적인 레벨 흐름을 만들고, 목록에 있는 SKILL.md 플레이스홀더 항목들도 그에 맞춰 헤딩 레벨을 맞춰 정렬하세요.

Comment on lines +61 to +94
```
## Issue Number
DH-{id}

## As-Is
### 1. 기존 동작 및 문제 상황
- {기존에 어떤 동작/상태였는지}
- {어떤 문제가 발생했는지}

### 2. 대안 분석 (각 접근 방식의 장단점)
- {방식 A}: {장점} / {단점}
- {방식 B}: {장점} / {단점}

## To-Be
### 1. 최종 구현 결과
- {구현된 핵심 내용}

### 2. 기존 대비 변경 내역
- {변경 전} → {변경 후}

### 3. 미해결 이슈 및 향후 검토 사항
- {남은 이슈 또는 추가 검토 필요 사항}

## ✅ Check List
- [x] Have all tests passed?
- [x] Have all commits been pushed?
- [x] Did you verify the target branch for the merge?
- [ ] Did you assign the appropriate assignee(s)?
- [ ] Did you set the correct label(s)?

## 📸 Test Screenshot

## Additional Description
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

코드 블록에 언어 식별자를 추가하세요.

fenced code block에 언어가 지정되지 않아 lint 경고가 발생합니다.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 61-61: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-impl-plan.md` around lines 61 - 94, The
fenced code block starting with ``` before the "## Issue Number" section has no
language identifier causing lint warnings; fix it by changing the opening fence
to include a language (e.g., add "markdown" or "md" after the opening ```), and
apply the same change to any other anonymous fenced blocks in the document to
remove the lint warning (locate the block by the opening ``` and the "## Issue
Number" header).

Comment on lines +138 to +149
```
## Summary

### Major Changes
- {description} @{author-github-id}

### Minor Changes
- {description} @{author-github-id}

### Patch Changes
- {description} @{author-github-id}
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

코드 블록에 언어 식별자를 추가하세요.

fenced code block에 언어가 지정되지 않아 lint 경고가 발생합니다.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 138-138: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In `@docs/plans/2026-02-15-pr-skills-impl-plan.md` around lines 138 - 149, The
fenced code block that begins with ``` before the "## Summary" section lacks a
language identifier, causing lint warnings; change the opening fence from ``` to
```markdown (or ```md) to mark the block as Markdown so the linter recognizes
it, and similarly add language identifiers to any other untyped fenced blocks in
the same file (look for the triple-backtick fences surrounding "## Summary",
"### Major Changes", etc.).

@codrin2
Copy link
Member Author

codrin2 commented Feb 15, 2026

브랜치 이름 변경으로 PR 재생성합니다 (codrin2/create-pr-skills → feat/DH-6)

@codrin2 codrin2 closed this Feb 15, 2026
@codrin2 codrin2 deleted the codrin2/create-pr-skills branch February 15, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant