● Overview κ°œμš”

ROACH PI provides /review β€” a single-pass code review performed directly by the current agent. Fast, lightweight, and free of subagent overhead.

ROACH PIλŠ” /reviewλ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€ β€” ν˜„μž¬ μ—μ΄μ „νŠΈκ°€ 직접 μˆ˜ν–‰ν•˜λŠ” 단일 패슀 μ½”λ“œ 리뷰. λΉ λ₯΄κ³  κ°€λ²Όμš°λ©° μ„œλΈŒμ—μ΄μ „νŠΈ μ˜€λ²„ν—€λ“œκ°€ μ—†μŠ΅λ‹ˆλ‹€.

β–Ά /review β€” Single-Pass Review β€” 단일 패슀 리뷰

Syntax ꡬ문

/review [target]

target can be a PR number, PR URL, branch name, or omitted for auto-detection. No confirmation is required β€” the review starts immediately.

target은 PR 번호, PR URL, 브랜치 이름, λ˜λŠ” μžλ™ 감지λ₯Ό μœ„ν•΄ μƒλž΅ν•  수 μžˆμŠ΅λ‹ˆλ‹€. 확인 없이 리뷰가 μ¦‰μ‹œ μ‹œμž‘λ©λ‹ˆλ‹€.

Target Validation νƒ€κ²Ÿ 검증

The target is validated against /^[a-zA-Z0-9._/:\-]+$/ before any prompt is sent. Shell metacharacters (;, |, &, >, `, $()) are rejected immediately to prevent injection into the downstream gh / git commands.

νƒ€κ²Ÿμ€ ν”„λ‘¬ν”„νŠΈ 전솑 전에 /^[a-zA-Z0-9._/:\-]+$/둜 κ²€μ¦λ©λ‹ˆλ‹€. μ…Έ λ©”νƒ€λ¬Έμž(;, |, &, >, `, $())λŠ” λ‹€μš΄μŠ€νŠΈλ¦Ό gh / git λͺ…λ Ήμ–΄λ‘œμ˜ μΈμ μ…˜μ„ λ°©μ§€ν•˜κΈ° μœ„ν•΄ μ¦‰μ‹œ κ±°λΆ€λ©λ‹ˆλ‹€.

Review Output 리뷰 좜λ ₯

The review is output directly to chat, grouped by file. Each finding includes: what, where (file:line), severity (Critical/High/Medium/Low), and a one-line suggested fix. No file is saved and no subagents are dispatched.

λ¦¬λ·°λŠ” νŒŒμΌλ³„λ‘œ κ·Έλ£Ήν™”λ˜μ–΄ μ±„νŒ…μ— 직접 좜λ ₯λ©λ‹ˆλ‹€. 각 발견 사항은 λ‚΄μš©, μœ„μΉ˜(file:line), 심각도(Critical/High/Medium/Low), ν•œ 쀄 μˆ˜μ • μ œμ•ˆμ„ ν¬ν•¨ν•©λ‹ˆλ‹€. νŒŒμΌμ€ μ €μž₯λ˜μ§€ μ•Šκ³  μ„œλΈŒμ—μ΄μ „νŠΈλ„ λ””μŠ€νŒ¨μΉ˜λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.

β–  Diff Commands Diff λͺ…λ Ήμ–΄

/review resolves its target with the following logic:

/reviewλŠ” λ‹€μŒ 둜직으둜 νƒ€κ²Ÿμ„ ν•΄κ²°ν•©λ‹ˆλ‹€:

Targetνƒ€κ²Ÿ Commandλͺ…λ Ήμ–΄
PR numberPR 번호 gh pr diff <number>
PR URLPR URL gh pr diff <url>
Branch name브랜치 이름 git diff main...<topic>
Auto (PR found)μžλ™ (PR 발견) gh pr list --head <branch> β†’ gh pr diff <number>
Auto (no PR)μžλ™ (PR μ—†μŒ) git diff main...HEAD + git diff + git diff --cached
πŸ’‘ NoteπŸ’‘ μ°Έκ³ 

gh accepts PR numbers and full GitHub PR URLs interchangeably β€” no special URL parsing is needed.

ghλŠ” PR λ²ˆν˜Έμ™€ 전체 GitHub PR URL을 μƒν˜Έ κ΅ν™˜μ μœΌλ‘œ ν—ˆμš©ν•©λ‹ˆλ‹€ β€” λ³„λ„μ˜ URL νŒŒμ‹±μ΄ ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.