| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| Invoke | /pr-review-processor |
/pr-review-processor โ PR์ ๋ฌ๋ฆฐ AI ๋ฆฌ๋ทฐ ์๋ ์ฒ๋ฆฌ๊ธฐ#
ํ๋ง๋๋ก#
PR(์ฝ๋ ๋ณ๊ฒฝ ์ ์์)์ AI ๋ฆฌ๋ทฐ์ด(Claude, Gemini ๋ฑ)๊ฐ ๋จ๊ธด ์ง์ ์ฌํญ์ ์ฌ๋์ด ์ผ์ผ์ด ์ฝ๊ณ ๊ณ ์น๋ ๋์ , ์๋์ผ๋ก ๊ฒํ ํด์ ํ๋นํ๋ฉด ์ฝ๋๋ฅผ ๊ณ ์น๊ณ ์๋๋ฉด ๋ฌด์ ๊ท์น์ ๊ธฐ๋กํด ์ฃผ๋ ๋๊ตฌ์ ๋๋ค. ๋ง์น ๊ต์ ์๊ฐ ๋นจ๊ฐ ํ์ผ๋ก ํ์ํด ๋ ์๊ณ ๋ฅผ, ํธ์ง์๊ฐ ๋ฐ์ ๊ฑด ๋ฐ๊ณ ๊ฑฐ๋ฅผ ๊ฑด ๊ฑฐ๋ฅด๋ฉฐ ํ ๋ฒ์ ์ ๋ฆฌํด ์ฃผ๋ ๊ฒ๊ณผ ๊ฐ์์.
๋๊ฐยท์ธ์ ์ฐ๋์#
- PR์ ClaudeยทGeminiยทCopilot ๊ฐ์ AI ์ฝ๋ ๋ฆฌ๋ทฐ ๋ด์ด ์๋์ผ๋ก ์ฝ๋ฉํธ๋ฅผ ๋ฌ์ ๋ ์ํฉ
- ๊ทธ ๋ฆฌ๋ทฐ ์ฝ๋ฉํธ๋ค์ ํ๋์ฉ ์ง์ ์ฝ๊ณ ๋ฐ์ํ๊ธฐ ๋ฒ๊ฑฐ๋ก์ธ ๋, ํ ๋ฒ์ ๊ฒํ ยท์ ์ฉํ๊ณ ์ถ์ ๋
๋ฌด์์ ํด์ฃผ๋์#
-
PR์ ๋ฌ๋ฆฐ ๋ฆฌ๋ทฐ ์ฝ๋ฉํธ๋ฅผ ๋ชจ์ ํ๋นํ ๊ฒ์ ์ฝ๋๋ฅผ ๊ณ ์ณ ์ปค๋ฐํ๊ณ , ํ๋นํ์ง ์์ ๊ฒ์
CLAUDE.md์ ๊ท์น์ผ๋ก ๋จ๊ฒจ ๋ค์๋ถํฐ ๊ฐ์ ์ง์ ์ด ๋ฐ๋ณต๋์ง ์๊ฒ ๋ง์ ์ค๋๋ค. - ๋ณ๊ฒฝ ์ฌํญ์ push ํ๊ณ , ์ด๋ค ๋ฆฌ๋ทฐ๋ฅผ ์ด๋ป๊ฒ ์ฒ๋ฆฌํ๋์ง ๊ฒฐ๊ณผ ์์ฝ์ ๋ณด์ฌ ์ค๋๋ค.
์ด๋ป๊ฒ ์ฐ๋์#
/pr-review-processor [PR_number]
[PR_number]์๋ฆฌ์ ์ฒ๋ฆฌํ๊ณ ์ถ์ PR ๋ฒํธ๋ฅผ ๋ฃ์ต๋๋ค. (์: ํน์ PR ํ ๊ฑด์ ๋ฆฌ๋ทฐ๋ฅผ ์ ๋ฆฌ)
์์์ ๋ฌด์จ ์ผ์ด ๋ฒ์ด์ง๋์#
- ๋ฆฌ๋ทฐ ์์ง โ ํด๋น PR์ ๋ฌ๋ฆฐ ๋ฆฌ๋ทฐ ์ฝ๋ฉํธ๋ฅผ ๋ชจ๋ ๊ฐ์ ธ์ต๋๋ค.
- ๋ฆฌ๋ทฐ ๋ถ์ โ ๊ฐ ์ฝ๋ฉํธ๊ฐ "ํ๋นํ ๋ฆฌ๋ทฐ"(์ฝ๋ ํ์งยทUXยท์ฑ๋ฅยท๋ณด์ ๊ฐ์ ์ ์)์ธ์ง, "ํ๋นํ์ง ์์ ๋ฆฌ๋ทฐ"(ํ๋ก์ ํธ ๊ท์น๊ณผ ์ถฉ๋ํ๋ ์ ์)์ธ์ง ๊ฐ๋ ค๋ ๋๋ค.
- ์กฐ์น โ ํ๋นํ๋ฉด ์ฝ๋๋ฅผ ๊ณ ์ณ ์ปค๋ฐํ๊ณ , ํ๋นํ์ง ์์ผ๋ฉด
CLAUDE.md์ ๊ท์น์ ์ถ๊ฐํด ์์ผ๋ก ๊ฐ์ ์ง์ ์ ๋ง์ต๋๋ค. - ๋ง๋ฌด๋ฆฌ โ ๋ณ๊ฒฝ ์ฌํญ์ push ํ๊ณ ์ฒ๋ฆฌ ๊ฒฐ๊ณผ๋ฅผ ์์ฝํฉ๋๋ค.
์ฐธ๊ณ ๋ก, ๋ค์ ๊ฒฝ์ฐ์๋ ๋ฆฌ๋ทฐ๋ฅผ ๋ฌด์ํ๊ณ CLAUDE.md ๊ท์น์ผ๋ก ๊ธฐ๋กํฉ๋๋ค: ํ๋ก์ ํธ lint ๊ท์น๊ณผ ์ถฉ๋, ๊ธฐ์กด ์ํคํ
์ฒ ํจํด๊ณผ ๋ถ์ผ์น, ์คํ๋ ค ์ฑ๋ฅ์ ๋จ์ด๋จ๋ฆฌ๋ ์ ์.
โ๏ธ ์์ธ ์ต์ ยท์คํ ๋ช ์ธ (๊ฐ๋ฐ์ / AI ์์ด์ ํธ์ฉ)
Usage#
/pr-review-processor [PR_number]Workflow#
1. Collect Reviews#
gh api repos/{owner}/{repo}/pulls/{pr_number}/comments2. Analyze Reviews#
For each review comment:
- Valid review: Code quality, UX, performance, security improvement suggestions
- Invalid review: Suggestions conflicting with project conventions
3. Take Action#
- Valid review โ modify code and commit
- Invalid review โ add rule to CLAUDE.md (prevent in future)
4. Complete#
- Push changes
- Summarize processing results
Reviewer Identification#
| Reviewer | Identifier |
|---|---|
| Gemini | gemini-code-assist[bot] |
| Claude | claude[bot] |
| Copilot | github-copilot[bot] |
Priorities#
Review priority icons:
- ๐ด
critical- Immediate fix required - ๐
high- High priority - ๐ก
medium- Medium priority - ๐ข
low- Low priority
Auto-Reject Conditions#
Reviews are ignored and CLAUDE.md rule added in these cases:
- Conflicts with project lint rules
- Inconsistent with existing architecture patterns
- Suggestion that would cause performance degradation