Code Review
ãã«ããšãŒãžã§ã³ãåæã䜿çšããŠã³ãŒãããŒã¹å šäœãæ€æ»ããããžãã¯ãšã©ãŒãã»ãã¥ãªãã£è匱æ§ããªã°ã¬ãã·ã§ã³ãæ€åºããèªååããã PR ã¬ãã¥ãŒãèšå®ããŸã
Code Review ã¯ãªãµãŒããã¬ãã¥ãŒæ®µéã§ãããTeam ããã³ Enterprise ãµãã¹ã¯ãªãã·ã§ã³ã§å©çšå¯èœã§ããZero Data Retention ãæå¹ã«ãªã£ãŠããçµç¹ã§ã¯å©çšã§ããŸããã
Code Review 㯠GitHub ãã«ãªã¯ãšã¹ããåæããã³ãŒãã®åé¡ãèŠã€ãã£ãè¡ã«ã€ã³ã©ã€ã³ã³ã¡ã³ããšããŠçµæãæçš¿ããŸããç¹åãããšãŒãžã§ã³ãã®ããªãŒããã³ãŒã倿Žãã³ãŒãããŒã¹å šäœã®ã³ã³ããã¹ãã§æ€æ»ããããžãã¯ãšã©ãŒãã»ãã¥ãªãã£è匱æ§ãå£ãããšããžã±ãŒã¹ã埮åŠãªãªã°ã¬ãã·ã§ã³ãæ¢ããŸãã
çµæã¯é倧床ã§ã¿ã°ä»ããããPR ãæ¿èªãŸãã¯ãããã¯ããªããããæ¢åã®ã¬ãã¥ãŒã¯ãŒã¯ãããŒã¯ãã®ãŸãŸæ©èœããŸãããªããžããªã« CLAUDE.md ãŸã㯠REVIEW.md ãã¡ã€ã«ã远å ããããšã§ãClaude ããã©ã°ãç«ãŠãå
容ãã«ã¹ã¿ãã€ãºã§ããŸãã
Claude ã管çãµãŒãã¹ã§ã¯ãªãç¬èªã® CI ã€ã³ãã©ã¹ãã©ã¯ãã£ã§å®è¡ããå Žåã¯ãGitHub Actions ãŸã㯠GitLab CI/CD ãåç §ããŠãã ãããèªå·±ãã¹ãå GitHub ã€ã³ã¹ã¿ã³ã¹äžã®ãªããžããªã«ã€ããŠã¯ãGitHub Enterprise Server ãåç §ããŠãã ããã
ãã®ããŒãžã§ã¯ä»¥äžãã«ããŒããŠããŸãïŒ
- ã¬ãã¥ãŒã®ä»çµã¿
- ã»ããã¢ãã
@claude reviewãš@claude review onceã䜿çšããã¬ãã¥ãŒã®æåããªã¬ãŒCLAUDE.mdãšREVIEW.mdã䜿çšããã¬ãã¥ãŒã®ã«ã¹ã¿ãã€ãº- æé
- ãã©ãã«ã·ã¥ãŒãã£ã³ã°å€±æããå®è¡ã𿬠èœããã³ã¡ã³ã
- ããŒã«ã«ã§å·®åãã¬ãã¥ãŒãã
/code-reviewã³ãã³ãã䜿çš
GitHub ã¢ããªãã€ã³ã¹ããŒã«ããã«ã¿ãŒããã«ã§ããŒã«ã«ã«å·®åãã¬ãã¥ãŒããã«ã¯ãä»»æã® Claude Code ã»ãã·ã§ã³ã§ /code-review ã³ãã³ããå®è¡ããŠãã ãããããŒã«ã«ã§å·®åãã¬ãã¥ãŒãããåç
§ããŠãã ããã
ã¬ãã¥ãŒã®ä»çµã¿
管çè
ãçµç¹ã® Code Review ãæå¹ã«ãããšããªããžããªã®èšå®ãããåäœã«å¿ããŠãPR ãéããããšãããã¹ãŠã®ããã·ã¥æããŸãã¯æåã§ãªã¯ãšã¹ãããããšãã«ã¬ãã¥ãŒãããªã¬ãŒãããŸããPR ã§ @claude review ãšã³ã¡ã³ããããšãä»»æã®ã¢ãŒãã§ã¬ãã¥ãŒãéå§ãããŸãã
ã¬ãã¥ãŒãå®è¡ããããšãè€æ°ã®ãšãŒãžã§ã³ãã Anthropic ã€ã³ãã©ã¹ãã©ã¯ãã£äžã§äžŠè¡ã㊠diff ãšåšå²ã®ã³ãŒããåæããŸããåãšãŒãžã§ã³ãã¯ç°ãªãã¯ã©ã¹ã®åé¡ãæ¢ãããã®åŸãæ€èšŒã¹ããããåè£ãå®éã®ã³ãŒãåäœã«å¯ŸããŠãã§ãã¯ããŠãåœéœæ§ãé€å€ããŸããçµæã¯éè€æé€ãããé倧床ã§ã©ã³ã¯ä»ããããåé¡ãèŠã€ãã£ãç¹å®ã®è¡ã«ã€ã³ã©ã€ã³ã³ã¡ã³ããšããŠæçš¿ãããã¬ãã¥ãŒæ¬æã«æŠèŠãèšèŒãããŸããåé¡ãèŠã€ãããªãå ŽåãCode Review 㯠GitHub ãã§ãã¯å®è¡ãæŽæ°ããŠãåé¡ãæ€åºãããªãã£ãããšã衚瀺ããŸããClaude 㯠PR ã«çã確èªã³ã¡ã³ããæçš¿ããããšããããŸãã
ã¬ãã¥ãŒã¯ã³ã¹ãã PR ã®ãµã€ãºãšè€éãã«å¿ããŠã¹ã±ãŒãªã³ã°ãããå¹³å 20 åã§å®äºããŸãã管çè ã¯åæããã·ã¥ããŒããéããŠã¬ãã¥ãŒã¢ã¯ãã£ããã£ãšæ¯åºãç£èŠã§ããŸãã
é倧床ã¬ãã«
åçµæã¯é倧床ã¬ãã«ã§ã¿ã°ä»ããããŸãïŒ
| ããŒã«ãŒ | é倧床 | æå³ |
|---|---|---|
| ðŽ | Important | ããŒãžåã«ä¿®æ£ãã¹ããã° |
| ð¡ | Nit | 軜埮ãªåé¡ãä¿®æ£ãã䟡å€ããããããããã³ã°ã§ã¯ãªã |
| ð£ | Pre-existing | ã³ãŒãããŒã¹ã«ååšãããããã® PR ã§å°å ¥ãããªãã£ããã° |
çµæã«ã¯ãå±éå¯èœãªæ¡åŒµæšè«ã»ã¯ã·ã§ã³ãå«ãŸããŠãããClaude ããªãåé¡ããã©ã°ç«ãŠããã®ããã©ã®ããã«åé¡ãæ€èšŒããã®ããçè§£ããããã«å±éã§ããŸãã
çµæã«å¯Ÿããè©äŸ¡ãšè¿ä¿¡
Claude ããã®åã¬ãã¥ãŒã³ã¡ã³ãã«ã¯ãð ãš ð ãæ¢ã«æ·»ä»ãããŠãããããGitHub UI ã§äž¡æ¹ã®ãã¿ã³ãã¯ã³ã¯ãªãã¯è©äŸ¡ã®ããã«è¡šç€ºãããŸããçµæãæçšã ã£ãå Žå㯠ð ãã¯ãªãã¯ããééã£ãŠãããéšã ããã£ãå Žå㯠ð ãã¯ãªãã¯ããŠãã ãããAnthropic 㯠PR ãããŒãžãããåŸã«ãªã¢ã¯ã·ã§ã³ã«ãŠã³ããåéããããã䜿çšããŠã¬ãã¥ã¢ãŒããã¥ãŒãã³ã°ããŸãããªã¢ã¯ã·ã§ã³ã¯åã¬ãã¥ãŒãããªã¬ãŒããããPR äžã®äœãã倿ŽãããããŸããã
ã€ã³ã©ã€ã³ã³ã¡ã³ãã«è¿ä¿¡ããŠããClaude ãå¿çããã PR ãæŽæ°ãããããããã«ããã³ãããããŸãããçµæã«å¯ŸåŠããã«ã¯ãã³ãŒããä¿®æ£ããŠããã·ã¥ããŠãã ãããPR ãããã·ã¥ããªã¬ãŒã¬ãã¥ãŒã«ãµãã¹ã¯ã©ã€ããããŠããå Žåãæ¬¡ã®å®è¡ã¯åé¡ãä¿®æ£ããããšã¹ã¬ããã解決ããŸããããã·ã¥ããã«æ°ããã¬ãã¥ãŒããªã¯ãšã¹ãããã«ã¯ããããã¬ãã«ã® PR ã³ã¡ã³ããšã㊠@claude review once ãšã³ã¡ã³ãããŠãã ããã
ãã§ãã¯å®è¡åºå
ã€ã³ã©ã€ã³ã¬ãã¥ãŒã³ã¡ã³ãã«å ããŠãåã¬ãã¥ãŒã¯ CI ãã§ãã¯ãšäžŠãã§è¡šç€ºããã Claude Code Review ãã§ãã¯å®è¡ãçæããŸãããã® Details ãªã³ã¯ãå±éããŠããã¹ãŠã®çµæã®æŠèŠã 1 ãæã§ç¢ºèªã§ããé倧床ã§ãœãŒããããŠããŸãïŒ
| é倧床 | ãã¡ã€ã«:è¡ | åé¡ |
|---|---|---|
| ðŽ Important | src/auth/session.ts:142 |
ããŒã¯ã³æŽæ°ããã°ã¢ãŠããšç«¶åããå€ãã»ãã·ã§ã³ãã¢ã¯ãã£ããªãŸãŸã«ãªã |
| ð¡ Nit | src/auth/session.ts:88 |
parseExpiry ã¯äžæ£ãªåœ¢åŒã®å
¥åã§é»ã£ãŠ 0 ãè¿ã |
åçµæã¯ãFiles changed ã¿ãã®æ³šéãšããŠã衚瀺ãããé¢é£ãã diff è¡ã«çŽæ¥ããŒã¯ãããŸããImportant ã®çµæã¯èµ€ãããŒã«ãŒã§ãnit ã¯é»è²ã®èŠåã§ãæ¢åã®ãã°ã¯ç°è²ã®éç¥ã§ã¬ã³ããªã³ã°ãããŸããæ³šéãšé倧床ããŒãã«ã¯ã€ã³ã©ã€ã³ã¬ãã¥ãŒã³ã¡ã³ããšã¯ç¬ç«ããŠãã§ãã¯å®è¡ã«æžã蟌ãŸãããããç§»åããè¡ã®ã€ã³ã©ã€ã³ã³ã¡ã³ãã GitHub ã«æåŠãããå Žåã§ãå©çšå¯èœãªãŸãŸã§ãã
ãã§ãã¯å®è¡ã¯åžžã«äžç«çãªçµè«ã§å®äºããããããã©ã³ãä¿è·ã«ãŒã«ãéããŠããŒãžããããã¯ããããšã¯ãããŸãããCode Review ã®çµæã«åºã¥ããŠããŒãžãã²ãŒããããå Žåã¯ããã§ãã¯å®è¡åºåããé倧床ã®å
èš³ãèªã¿åããç¬èªã® CI ã§äœ¿çšããŠãã ãããDetails ããã¹ãã®æåŸã®è¡ã¯ãã¯ãŒã¯ãããŒã gh ãš jq ã§è§£æã§ãããã·ã³å¯èªã³ã¡ã³ãã§ãïŒ
gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
--jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
ããã¯é倧床ããšã®ã«ãŠã³ããå«ã JSON ãªããžã§ã¯ããè¿ããŸããäŸãã° {"normal": 2, "nit": 1, "pre_existing": 0} ã§ããnormal ããŒã¯ Important ã®çµæã®ã«ãŠã³ããä¿æããŸãããŒã以å€ã®å€ã¯ãClaude ãããŒãžåã«ä¿®æ£ãã䟡å€ã®ãããã°ãå°ãªããšã 1 ã€èŠã€ããããšãæå³ããŸãã
Code Review ããã§ãã¯ããå 容
ããã©ã«ãã§ã¯ãCode Review ã¯æ£ç¢ºæ§ã«çŠç¹ãåœãŠãŠããŸãïŒãã©ãŒãããèšå®ã®å¥œã¿ããã¹ãã«ãã¬ããžã®æ¬ èœã§ã¯ãªããæ¬çªç°å¢ãå£ããã°ã§ãããªããžããªã«ã¬ã€ãã³ã¹ãã¡ã€ã«ã远å ããããšã§ããã§ãã¯å å®¹ãæ¡åŒµã§ããŸãã
Code Review ã®ã»ããã¢ãã
管çè ãçµç¹ã«å¯Ÿã㊠Code Review ã 1 åæå¹ã«ããå«ãããªããžããªãéžæããŸãã
Claude Code 管çèšå®ãéã
claude.ai/admin-settings/claude-code ã«ã¢ã¯ã»ã¹ããŠãCode Review ã»ã¯ã·ã§ã³ãèŠã€ããŸããClaude çµç¹ãžã®ç®¡çè ã¢ã¯ã»ã¹ãš GitHub çµç¹ã« GitHub Apps ãã€ã³ã¹ããŒã«ããæš©éãå¿ èŠã§ãã
ã»ããã¢ãããéå§ãã
Setup ãã¯ãªãã¯ããŸããããã«ãã GitHub App ã€ã³ã¹ããŒã«ãããŒãéå§ãããŸãã
Claude GitHub App ãã€ã³ã¹ããŒã«ãã
ããã³ããã«åŸã£ãŠãClaude GitHub App ã GitHub çµç¹ã«ã€ã³ã¹ããŒã«ããŸããã¢ããªã¯ä»¥äžã®ãªããžããªæš©éããªã¯ãšã¹ãããŸãïŒ
- Contents: èªã¿åããšæžã蟌ã¿
- Issues: èªã¿åããšæžã蟌ã¿
- Pull requests: èªã¿åããšæžã蟌ã¿
Code Review 㯠contents ãžã®èªã¿åãã¢ã¯ã»ã¹ãš pull requests ãžã®æžã蟌ã¿ã¢ã¯ã»ã¹ã䜿çšããŸããããåºãæš©éã»ããã¯ãåŸã§æå¹ã«ããå ŽåãGitHub Actions ããµããŒãããŸãã
ãªããžããªãéžæãã
Code Review ãæå¹ã«ãããªããžããªãéžæããŸãããªããžããªã衚瀺ãããªãå Žåã¯ãã€ã³ã¹ããŒã«äžã« Claude GitHub App ã«ã¢ã¯ã»ã¹æš©ãä»äžããããšã確èªããŠãã ãããåŸã§ãªããžããªã远å ã§ããŸãã
ãªããžããªããšã«ã¬ãã¥ãŒããªã¬ãŒãèšå®ãã
ã»ããã¢ãããå®äºãããšãCode Review ã»ã¯ã·ã§ã³ã¯ãªããžããªãããŒãã«ã«è¡šç€ºããŸããåãªããžããªã«ã€ããŠãReview Behavior ããããããŠã³ã䜿çšããŠã¬ãã¥ãŒãå®è¡ãããã¿ã€ãã³ã°ãéžæããŸãïŒ
- Once after PR creation: PR ãéãããã ready for review ãšããŠããŒã¯ããããšãã«ã¬ãã¥ãŒã 1 åå®è¡ãããŸã
- After every push: PR ãã©ã³ããžã®ãã¹ãŠã®ããã·ã¥ã§ã¬ãã¥ãŒãå®è¡ãããPR ãé²åããã«ã€ããŠæ°ããåé¡ããã£ãããããã©ã°ãç«ãŠãããåé¡ãä¿®æ£ãããšã¹ã¬ãããèªå解決ããŸã
- Manual: PR ã§
@claude reviewãŸãã¯@claude review onceãšã³ã¡ã³ããããšãã®ã¿ã¬ãã¥ãŒãéå§ãããŸãã@claude reviewã¯ãŸãããã®åŸã®ããã·ã¥ã§ã¬ãã¥ãŒã« PR ããµãã¹ã¯ã©ã€ãããŸã
ãã¹ãŠã®ããã·ã¥ã§ã¬ãã¥ãŒãããšãæãå€ãã®ã¬ãã¥ãŒãå®è¡ãããæãã³ã¹ããããããŸããManual ã¢ãŒãã¯ãç¹å®ã® PR ãã¬ãã¥ãŒã«ãªããã€ã³ãããé«ãã©ãã£ãã¯ãªããžããªããŸã㯠PR ã ready ã«ãªã£ãã PR ã®ã¬ãã¥ãŒãéå§ãããå Žåã«äŸ¿å©ã§ãã
ãªããžããªããŒãã«ã¯ãæè¿ã®ã¢ã¯ãã£ããã£ã«åºã¥ããŠåãªããžããªã®å¹³åã¬ãã¥ãŒã³ã¹ãã衚瀺ããŸããè¡ã¢ã¯ã·ã§ã³ã¡ãã¥ãŒã䜿çšããŠããªããžããªããšã« Code Review ããªã³ãŸãã¯ãªãã«ãããããªããžããªãå®å šã«åé€ããŸãã
ã»ããã¢ããã確èªããã«ã¯ããã¹ã PR ãéããŸããèªåããªã¬ãŒãéžæããå ŽåãClaude Code Review ãšããååã®ãã§ãã¯å®è¡ãæ°å以å
ã«è¡šç€ºãããŸããManual ãéžæããå Žåã¯ãPR ã§ @claude review ãšã³ã¡ã³ãããŠæåã®ã¬ãã¥ãŒãéå§ããŸãããã§ãã¯å®è¡ã衚瀺ãããªãå Žåã¯ããªããžããªã管çèšå®ã«äžèŠ§è¡šç€ºãããŠããããšãšãClaude GitHub App ãã¢ã¯ã»ã¹æš©ãæã£ãŠããããšã確èªããŠãã ããã
ã¬ãã¥ãŒãæåã§ããªã¬ãŒãã
2 ã€ã®ã³ã¡ã³ãã³ãã³ãããªã³ããã³ãã§ã¬ãã¥ãŒãéå§ããŸããã©ã¡ãããªããžããªã®èšå®ãããããªã¬ãŒã«é¢ä¿ãªãæ©èœãããããManual ã¢ãŒãã§ç¹å®ã® PR ãã¬ãã¥ãŒã«ãªããã€ã³ããããä»ã®ã¢ãŒãã§å³åº§ã«åã¬ãã¥ãŒãååŸããããã«äœ¿çšã§ããŸãã
| ã³ãã³ã | å®è¡å 容 |
|---|---|
@claude review |
ã¬ãã¥ãŒãéå§ãããã®åŸã®ããã·ã¥ã§ã¬ãã¥ãŒãããªã¬ãŒãããããã« PR ããµãã¹ã¯ã©ã€ãããŸã |
@claude review once |
ä»åŸã®ããã·ã¥ã«ãµãã¹ã¯ã©ã€ãããã«åäžã®ã¬ãã¥ãŒãéå§ããŸã |
PR ã®çŸåšã®ç¶æ
ã«ã€ããŠãã£ãŒãããã¯ãå¿
èŠã ãããã®åŸã®ãã¹ãŠã®ããã·ã¥ã§ã¬ãã¥ãŒãçºçããã®ãæãŸãªãå Žåã¯ã@claude review once ã䜿çšããŸããããã¯é »ç¹ãªããã·ã¥ã䌎ãé·æéå®è¡ããã PR ããPR ã®ã¬ãã¥ãŒåäœã倿Žããã« 1 åéãã® 2 çªç®ã®æèŠãå¿
èŠãªå Žåã«äŸ¿å©ã§ãã
ã©ã¡ãã®ã³ãã³ãã§ãã¬ãã¥ãŒãããªã¬ãŒããã«ã¯ïŒ
- ãããã¬ãã«ã® PR ã³ã¡ã³ããšããŠæçš¿ããdiff è¡ã®ã€ã³ã©ã€ã³ã³ã¡ã³ãã§ã¯ãªã
- ã³ã¡ã³ãã®éå§ã«ã³ãã³ããé
眮ããã¯ã³ã·ã§ãã圢åŒã䜿çšããŠããå Žåã¯
onceãåãè¡ã«é 眮ããŸã - ãªããžããªãžã®ãªãŒããŒãã¡ã³ããŒããŸãã¯ã³ã©ãã¬ãŒã¿ãŒã¢ã¯ã»ã¹æš©ãæã€å¿ èŠããããŸã
- PR ã¯éããŠããå¿ èŠããããŸã
èªåããªã¬ãŒãšã¯ç°ãªããæåããªã¬ãŒã¯ãã©ãã PR ã§å®è¡ãããŸããæç€ºçãªãªã¯ãšã¹ãã¯ãã©ããã¹ããŒã¿ã¹ã«é¢ä¿ãªããä»ããã¬ãã¥ãŒãå¿ èŠã§ããããšã瀺ãããã§ãã
ãã® PR ã§ã¬ãã¥ãŒãæ¢ã«å®è¡ãããŠããå Žåããªã¯ãšã¹ãã¯é²è¡äžã®ã¬ãã¥ãŒãå®äºãããŸã§ãã¥ãŒã«å ¥ããŸããPR ã®ãã§ãã¯å®è¡ãéããŠé²æãç£èŠã§ããŸãã
ã¬ãã¥ãŒãã«ã¹ã¿ãã€ãºãã
Code Review ã¯ãªããžããªãã 2 ã€ã®ãã¡ã€ã«ãèªã¿åãããã©ã°ãç«ãŠãå 容ãã¬ã€ãããŸãããããã¯ããªãã¥ãŒã«ã©ã®çšåºŠåŒ·ã圱é¿ããããç°ãªããŸãïŒ
CLAUDE.md: Claude Code ããã¹ãŠã®ã¿ã¹ã¯ïŒã¬ãã¥ãŒã ãã§ã¯ãªãïŒã«äœ¿çšããå ±æãããžã§ã¯ãæç€ºãCode Review ã¯ããããããžã§ã¯ãã³ã³ããã¹ããšããŠèªã¿åããæ°ããå°å ¥ãããéåã nit ãšããŠãã©ã°ç«ãŠããŸããREVIEW.md: ã¬ãã¥ãŒã®ã¿ã®ã¬ã€ãã³ã¹ãã¬ãã¥ãŒãã€ãã©ã€ã³ã®ãã¹ãŠã®ãšãŒãžã§ã³ãã«æåªå ãšããŠçŽæ¥æ³šå ¥ãããŸãããã©ã°ãç«ãŠããã®ãé倧床ãçµæã®å ±åæ¹æ³ã倿Žããããã«äœ¿çšããŸãã
CLAUDE.md
Code Review ã¯ãªããžããªã® CLAUDE.md ãã¡ã€ã«ãèªã¿åããæ°ããå°å
¥ãããéåãnit ã¬ãã«ã®çµæãšããŠæ±ããŸããããã¯åæ¹åã«æ©èœããŸãïŒPR ã CLAUDE.md ã¹ããŒãã¡ã³ããå€ãããæ¹æ³ã§ã³ãŒãã倿Žããå ŽåãClaude ã¯ããã¥ã¡ã³ããæŽæ°ããå¿
èŠãããããšããã©ã°ç«ãŠããŸãã
Claude ã¯ãã£ã¬ã¯ããªéå±€ã®ãã¹ãŠã®ã¬ãã«ã§ CLAUDE.md ãã¡ã€ã«ãèªã¿åãããããµããã£ã¬ã¯ããªã® CLAUDE.md ã®ã«ãŒã«ã¯ãã®ãã¹ã®äžã®ãã¡ã€ã«ã«ã®ã¿é©çšãããŸããCLAUDE.md ã®ä»çµã¿ã®è©³çްã«ã€ããŠã¯ãmemory ããã¥ã¡ã³ããåç
§ããŠãã ããã
äžè¬ç㪠Claude Code ã»ãã·ã§ã³ã«é©çšããããªãã¬ãã¥ãŒåºæã®ã¬ã€ãã³ã¹ã«ã€ããŠã¯ã代ããã«REVIEW.mdã䜿çšããŸãã
REVIEW\.md
REVIEW.md ã¯ãªããžããªã«ãŒãã®ãã¡ã€ã«ã§ãCode Review ããªããžããªäžã§ã©ã®ããã«åäœãããããªãŒããŒã©ã€ãããŸãããã®å
容ã¯ãã¬ãã¥ãŒãã€ãã©ã€ã³ã®ãã¹ãŠã®ãšãŒãžã§ã³ãã®ã·ã¹ãã ããã³ããã«æåªå
ã®æç€ºãããã¯ãšããŠæ³šå
¥ãããããã©ã«ãã®ã¬ãã¥ãŒã¬ã€ãã³ã¹ããåªå
ãããŸãã
éèªçã«è²Œãä»ãããããããREVIEW.md ã¯ãã¬ãŒã³ãªæç€ºã§ãïŒ@ import æ§æã¯å±éããããåç
§ããããã¡ã€ã«ã¯ããã³ããã«èªã¿èŸŒãŸããŸãããå®è£
ãããã«ãŒã«ããã¡ã€ã«ã«çŽæ¥é
眮ããŸãã
ãã¥ãŒãã³ã°å¯èœãªå 容
REVIEW.md ã¯ããªãŒãã©ãŒã markdown ã§ãããããã¬ãã¥ãŒæç€ºãšããŠè¡šçŸã§ãããã®ã¯ãã¹ãŠã¹ã³ãŒãå
ã§ãã以äžã®ãã¿ãŒã³ã¯å®éã«æã圱é¿ããããŸãã
é倧床: ãªããžããªã® ðŽ Important ã®æå³ãåå®çŸ©ããŸããããã©ã«ãã®ãã£ãªãã¬ãŒã·ã§ã³ã¯æ¬çªã³ãŒããã¿ãŒã²ããã«ããŠããŸããããã¥ã¡ã³ããªããžããªãèšå®ãªããžããªããŸãã¯ãããã¿ã€ãã¯ãã¯ããã«çãå®çŸ©ãå¿
èŠãªå ŽåããããŸããImportant ã§ããçµæã®ã¯ã©ã¹ãšãæå€§ã§ã Nit ã§ããçµæã®ã¯ã©ã¹ãæç€ºçã«è¿°ã¹ãŸããå¥ã®æ¹åã«ãšã¹ã«ã¬ãŒãããããšãã§ããŸããäŸãã°ãããã©ã«ãã® nit ã§ã¯ãªããCLAUDE.md éåã Important ãšããŠæ±ãå Žåã§ãã
Nit ããªã¥ãŒã : åäžã®ã¬ãã¥ãŒãæçš¿ãã ð¡ Nit ã³ã¡ã³ãã®æ°ããã£ããããŸããæ£æãšèšå®ãã¡ã€ã«ã¯æ°žé ã«ç£šãããšãã§ããŸãããæå€§ 5 ã€ã® nit ãå ±åããæ®ããæŠèŠã®ã«ãŠã³ããšããŠèšåããããšãããããªãã£ããã¯ãã¬ãã¥ãŒãå®è¡å¯èœã«ä¿ã¡ãŸãã
ã¹ãããã«ãŒã«: Claude ãçµæãæçš¿ããªãã¹ããã¹ããã©ã³ããã¿ãŒã³ãçµæã«ããŽãªãäžèŠ§è¡šç€ºããŸããäžè¬çãªåè£ã¯ãçæãããã³ãŒããããã¯ãã¡ã€ã«ããã³ããŒãããäŸåé¢ä¿ããã·ã³äœæãã©ã³ããããã³ linting ãã¹ãã«ãã§ãã¯ãªã© CI ãæ¢ã«å®è£
ããŠãããã®ã§ããå®å
šãªç²Ÿæ»ãä¿èšŒããªããäœããã®ã¬ãã¥ãŒãä¿èšŒãããã¹ã«ã€ããŠã¯ãå®å
šã«ã¹ãããããã®ã§ã¯ãªããããé«ãããŒãèšå®ããŸãïŒãscripts/ ã§ã¯ãã»ãŒç¢ºå®ã§é倧ãªå Žåã®ã¿å ±åããŸããã
ãªããžããªåºæã®ãã§ãã¯: ãã¹ãŠã® PR ã§ãã©ã°ãç«ãŠããã«ãŒã«ã远å ããŸããäŸãã°ãæ°ãã API ã«ãŒãã«ã¯çµ±åãã¹ããå¿
èŠããREVIEW.md ã¯æåªå
ãšããŠæ³šå
¥ãããããããããã¯é·ã CLAUDE.md ã®åãã«ãŒã«ããã確å®ã«çå°ããŸãã
æ€èšŒããŒ: çµæã¯ã©ã¹ãæçš¿ãããåã«èšŒæ ãèŠæ±ããŸããäŸãã°ãåäœã¯ã¬ãŒã ã¯åœåããã®æšè«ã§ã¯ãªãããœãŒã¹ã® file:line åŒçšãå¿
èŠãã¯ãããã§ãªããã°èè
ã«åŸåŸ©ãè²»ããããåœéœæ§ãåæžããŸãã
åã¬ãã¥ãŒåæ: PR ãæ¢ã«ã¬ãã¥ãŒãããŠããå ŽåãClaude ãã©ã®ããã«åäœããããäŒããŸãããæåã®ã¬ãã¥ãŒåŸãæ°ãã nit ãæå¶ããImportant ã®çµæã®ã¿ãæçš¿ããããšãããããªã«ãŒã«ã¯ã1 è¡ã®ä¿®æ£ãã¹ã¿ã€ã«ã ãã§ 7 ã©ãŠã³ãç®ã«å°éããã®ãé²ããŸãã
æŠèŠã®åœ¢ç¶: ã¬ãã¥ãŒæ¬æã 2 factual, 4 style ã®ãã㪠1 è¡ã®ã¿ãªãŒã§éãããšãèŠæ±ãããã®å Žåã¯ããã¡ã¯ãã¥ã¢ã«ãªåé¡ãªããã§å§ããããšãèŠæ±ããŸããèè
ã¯è©³çްã®åã«äœæ¥ã®åœ¢ç¶ãç¥ãããã§ãã
äŸ
ãã® REVIEW.md ã¯ããã¯ãšã³ããµãŒãã¹ã®é倧床ãåãã£ãªãã¬ãŒã·ã§ã³ããnit ããã£ããããçæããããã¡ã€ã«ãã¹ããããããªããžããªåºæã®ãã§ãã¯ã远å ããŸãã
# ã¬ãã¥ãŒæç€º
## ããã§ Important ãæå³ãããã®
Important ã¯ãåäœãå£ããããŒã¿ããªãŒã¯ããããŸãã¯ããŒã«ããã¯ããããã¯ããçµæã®ããã«äºçŽããŸãïŒäžæ£ãªããžãã¯ãã¹ã³ãŒããããŠããªãããŒã¿ããŒã¹ã¯ãšãªããã°ãŸãã¯ãšã©ãŒã¡ãã»ãŒãžã® PIIãããã³åŸæ¹äºææ§ã®ãªããã€ã°ã¬ãŒã·ã§ã³ãã¹ã¿ã€ã«ãåœåããªãã¡ã¯ã¿ãªã³ã°ææ¡ã¯æå€§ã§ã Nit ã§ãã
## Nit ããã£ãããã
ã¬ãã¥ãŒããšã«æå€§ 5 ã€ã® Nit ãå ±åããŸããããã«èŠã€ããå Žåã¯ãã€ã³ã©ã€ã³ã§æçš¿ãã代ããã«ãæŠèŠã§ãplus N similar itemsããšèšããŸããèŠã€ãããã¹ãŠã Nit ã®å ŽåãæŠèŠããNo blocking issuesãã§å§ããŸãã
## å ±åããªã
- CI ãæ¢ã«å®è£
ããŠãããã®ïŒlintããã©ãŒããããåãšã©ãŒ
- `src/gen/` ã®äžã®çæããããã¡ã€ã«ãšä»»æã® `*.lock` ãã¡ã€ã«
- æ¬çªã«ãŒã«ãæå³çã«éåãããã¹ãã®ã¿ã®ã³ãŒã
## åžžã«ãã§ãã¯
- æ°ãã API ã«ãŒãã«ã¯çµ±åãã¹ãããã
- ãã°è¡ã«ã¡ãŒã«ã¢ãã¬ã¹ããŠãŒã¶ãŒ IDããŸãã¯ãªã¯ãšã¹ãæ¬æãå«ãŸããŠããªã
- ããŒã¿ããŒã¹ã¯ãšãªã¯åŒã³åºãå
ã®ããã³ãã«ã¹ã³ãŒããããŠãã
ãã©ãŒã«ã¹ãä¿ã€
é·ãã¯ã³ã¹ãããããŸãïŒé·ã REVIEW.md ã¯æãéèŠãªã«ãŒã«ãèããŸããã¬ãã¥ãŒåäœã倿Žããæç€ºã«ä¿ã¡ãäžè¬çãªãããžã§ã¯ãã³ã³ããã¹ã㯠CLAUDE.md ã«æ®ããŸãã
䜿çšç¶æ³ã衚瀺ãã
claude.ai/analytics/code-review ã«ã¢ã¯ã»ã¹ããŠãçµç¹å šäœã® Code Review ã¢ã¯ãã£ããã£ã確èªããŸããããã·ã¥ããŒãã¯ä»¥äžã衚瀺ããŸãïŒ
| ã»ã¯ã·ã§ã³ | 衚瀺å 容 |
|---|---|
| PRs reviewed | éžæããæéç¯å²ã§ã¬ãã¥ãŒããããã«ãªã¯ãšã¹ãã®æ¥æ¬¡ã«ãŠã³ã |
| Cost weekly | Code Review ã®é±æ¬¡æ¯åº |
| Feedback | éçºè ãåé¡ã«å¯ŸåŠããããèªå解決ãããã¬ãã¥ãŒã³ã¡ã³ãã®ã«ãŠã³ã |
| Repository breakdown | ãªããžããªããšã®ã¬ãã¥ãŒããã PR ãšã³ã¡ã³ã解決ã®ã«ãŠã³ã |
管çèšå®ã®ãªããžããªããŒãã«ã¯ãåãªããžããªã®å¹³åã¬ãã¥ãŒã³ã¹ãã衚瀺ããŸããããã·ã¥ããŒãã®ã³ã¹ãæ°å€ã¯æŽ»åãç£èŠããããã®æšå®å€ã§ããè«æ±æžã«æ£ç¢ºãªæ¯åºã«ã€ããŠã¯ãAnthropic ã®è«æ±æžãåç §ããŠãã ããã
æé
Code Review ã¯ããŒã¯ã³äœ¿çšéã«åºã¥ããŠè«æ±ãããŸããåã¬ãã¥ãŒã¯å¹³å $15ïœ25 ã®ã³ã¹ãã§ãPR ãµã€ãºãã³ãŒãããŒã¹ã®è€éããæ€èšŒãå¿ èŠãªåé¡ã®æ°ã«å¿ããŠã¹ã±ãŒãªã³ã°ãããŸããCode Review ã®äœ¿çšã¯usage creditsãéããŠåå¥ã«è«æ±ããããã©ã³ã®å«ãŸãã䜿çšéã«ã¯ã«ãŠã³ããããŸããã
éžæããã¬ãã¥ãŒããªã¬ãŒã¯ç·ã³ã¹ãã«åœ±é¿ããŸãïŒ
- Once after PR creation: PR ããšã« 1 åå®è¡ãããŸã
- After every push: åããã·ã¥ã§å®è¡ãããããã·ã¥æ°ã§ã³ã¹ããä¹ç®ãããŸã
- Manual: PR ã§èª°ãã
@claude reviewãšã³ã¡ã³ããããŸã§ã¬ãã¥ãŒã¯ãããŸãã
ã©ã®ã¢ãŒãã§ãã@claude review ãšã³ã¡ã³ããããšãPR ãããã·ã¥ããªã¬ãŒã¬ãã¥ãŒã«ãªããã€ã³ãããããããã®ã³ã¡ã³ãåŸã®ããã·ã¥ããšã«è¿œå ã³ã¹ããçºçããŸããä»åŸã®ããã·ã¥ã«ãµãã¹ã¯ã©ã€ãããã«åäžã®ã¬ãã¥ãŒãå®è¡ããã«ã¯ã代ããã« @claude review once ãšã³ã¡ã³ãããŠãã ããã
ã³ã¹ãã¯ãçµç¹ãä»ã® Claude Code æ©èœã« Amazon Bedrock ãŸã㯠Google Vertex AI ã䜿çšããŠãããã©ããã«é¢ä¿ãªããAnthropic ã®è«æ±æžã«è¡šç€ºãããŸããCode Review ã®ææ¬¡æ¯åºäžéãèšå®ããã«ã¯ãclaude.ai/admin-settings/usage ã«ã¢ã¯ã»ã¹ããŠãClaude Code Review ãµãŒãã¹ã®å¶éãèšå®ããŸãã
analytics ã®é±æ¬¡ã³ã¹ããã£ãŒããŸãã¯ç®¡çèšå®ã®ãªããžããªããšã®å¹³åã³ã¹ãåãéããŠæ¯åºãç£èŠããŸãã
ãã©ãã«ã·ã¥ãŒãã£ã³ã°
ã¬ãã¥ãŒå®è¡ã¯ãã¹ããšãã©ãŒãã§ãã倱æããå®è¡ã¯ PR ããããã¯ããããšã¯ãããŸããããèªåçã«å詊è¡ãããããšããããŸããããã®ã»ã¯ã·ã§ã³ã§ã¯ã倱æããå®è¡ããå埩ããæ¹æ³ãšããã§ãã¯å®è¡ãå ±åããåé¡ãèŠã€ãããªãå Žåã«ç¢ºèªããå Žæã«ã€ããŠèª¬æããŸãã
倱æãŸãã¯ã¿ã€ã ã¢ãŠãããã¬ãã¥ãŒãåããªã¬ãŒãã
ã¬ãã¥ãŒã€ã³ãã©ã¹ãã©ã¯ãã£ãå éšãšã©ãŒã«ééããããæéå¶éãè¶ ããå Žåããã§ãã¯å®è¡ã¯ Code review encountered an error ãŸã㯠Code review timed out ãšããã¿ã€ãã«ã§å®äºããŸããçµè«ã¯äŸç¶ãšããŠäžç«çã§ãããããããŒãžããããã¯ãããã®ã¯ãããŸããããçµæã¯æçš¿ãããŸããã
ã¬ãã¥ãŒãå床å®è¡ããã«ã¯ãPR ã§ @claude review once ãšã³ã¡ã³ãããŠãã ããããã㯠PR ãä»åŸã®ããã·ã¥ã«ãµãã¹ã¯ã©ã€ãããã«æ°ããã¬ãã¥ãŒãéå§ããŸããPR ãæ¢ã«ããã·ã¥ããªã¬ãŒã¬ãã¥ãŒã«ãµãã¹ã¯ã©ã€ããããŠããå Žåãæ°ããã³ããããããã·ã¥ããããšãæ°ããã¬ãã¥ãŒãéå§ããŸãã
GitHub ã® Checks ã¿ãã® Re-run ãã¿ã³ã¯ Code Review ãåããªã¬ãŒããŸãããã³ã¡ã³ãã³ãã³ããŸãã¯æ°ããããã·ã¥ã代ããã«äœ¿çšããŠãã ããã
ã¬ãã¥ãŒãå®è¡ããããPR ãæ¯åºäžéã¡ãã»ãŒãžã衚瀺ãã
çµç¹ã®ææ¬¡æ¯åºäžéã«éãããšãCode Review 㯠PR ã«åäžã®ã³ã¡ã³ããæçš¿ããã¬ãã¥ãŒãã¹ããããããããšã説æããŸããã¬ãã¥ãŒã¯æ¬¡ã®è«æ±æéã®éå§æã«èªåçã«åéããããã管çè ã claude.ai/admin-settings/usage ã§äžéãåŒãäžãããšããã«åéãããŸãã
ã€ã³ã©ã€ã³ã³ã¡ã³ããšããŠè¡šç€ºãããŠããªãåé¡ãèŠã€ãã
ãã§ãã¯å®è¡ã¿ã€ãã«ãåé¡ãèŠã€ãã£ããšèšã£ãŠããããdiff ã«ã€ã³ã©ã€ã³ã¬ãã¥ãŒã³ã¡ã³ãã衚瀺ãããªãå Žåã¯ãçµæã衚瀺ããããããã®ä»ã®å Žæã確èªããŠãã ããïŒ
- ãã§ãã¯å®è¡ Details: Checks ã¿ãã® Claude Code Review ãã§ãã¯ã®æšªã«ãã Details ãã¯ãªãã¯ããŸããé倧床ããŒãã«ã¯ãã€ã³ã©ã€ã³ã³ã¡ã³ããåãå ¥ãããããã©ããã«é¢ä¿ãªãããã¡ã€ã«ãè¡ãæŠèŠãå«ããã¹ãŠã®çµæãäžèŠ§è¡šç€ºããŸãã
- Files changed 泚é: PR ã® Files changed ã¿ããéããŸããçµæã¯ã¬ãã¥ãŒã³ã¡ã³ããšã¯å¥ã«ãdiff è¡ã«çŽæ¥æ·»ä»ãããæ³šéãšããŠã¬ã³ããªã³ã°ãããŸãã
- ã¬ãã¥ãŒæ¬æ: ã¬ãã¥ãŒãå®è¡ãããŠããéã« PR ã«ããã·ã¥ããå Žåãäžéšã®çµæã¯çŸåšã® diff ã«ååšããªããªã£ãè¡ãåç §ããå ŽåããããŸãããããã¯ãã€ã³ã©ã€ã³ã³ã¡ã³ãã§ã¯ãªããã¬ãã¥ãŒæ¬æããã¹ãã® Additional findings èŠåºãã®äžã«è¡šç€ºãããŸãã
ããŒã«ã«ã§å·®åãã¬ãã¥ãŒãã
/code-review ã³ãã³ãã¯ã¿ãŒããã«ã§å·®åãã¬ãã¥ãŒããGitHub App ãã€ã³ã¹ããŒã«ããã«å®è¡ããŸããä»»æã® Claude Code ã»ãã·ã§ã³ã§å®è¡ããŸãïŒæ£ç¢ºæ§ãã°ãå ±åãã{/* min-version: 2.1.151 */}åå©çšãç°¡çŽ åãå¹çåã®ã¯ãªãŒã³ã¢ãããå ±åããŸããããã©ã«ãã§ã¯ãããŒã«ã«ã¬ãã¥ãŒã¯ãã©ã³ãã®ã¢ããã¹ããªãŒã ããå
ã®ã³ããããšã¯ãŒãã³ã°ããªãŒã®æªã³ããã倿Žãã«ããŒããŸãã--comment ãæž¡ããŠã€ã³ã©ã€ã³ PR ã³ã¡ã³ããšããŠçµæãæçš¿ãããã--fix ãæž¡ããŠã¬ãã¥ãŒåŸã«çµæãã¯ãŒãã³ã°ããªãŒã«é©çšããŸãã
äœãåªåã¬ãã«ã¯ããå°ãªããããé«ãä¿¡é ŒåºŠã®çµæãè¿ããhigh ãã max ã¯ããåºãã«ãã¬ããžãæäŸããäžç¢ºå®ãªçµæãå«ãå ŽåããããŸããåªååŒæ°ããªãå Žåãã¬ãã¥ãŒã¯ã»ãã·ã§ã³ã®çŸåšã®åªåã䜿çšããŸããããã©ã«ãã®å·®å以å€ãã¬ãã¥ãŒããã«ã¯ãã¿ãŒã²ãããæž¡ããŸãïŒãã¡ã€ã«ãã¹ãPR çªå·ããã©ã³ãåããŸã㯠main...my-feature ãªã©ã® ref ç¯å²ã§ããref ç¯å²åœ¢åŒã¯ããã©ã³ãã®ã¢ããã¹ããªãŒã ãã©ã®ããã«èšå®ãããŠãããã«é¢ä¿ãªããmy-feature ãã main ãžã®ãã«ãªã¯ãšã¹ãã«å«ãŸããã³ãããæžã¿å·®åãã¬ãã¥ãŒããŸãã
/code-review ultra --fix ã¯ã¯ã©ãŠãã§ããæ·±ãultrareviewãå®è¡ããã»ãã·ã§ã³ã«æ»ã£ãŠãããšãã«çµæãã¯ãŒãã³ã°ããªãŒã«é©çšããŸããUltrareview ã¯ç¬èªã®ã¹ã³ãŒãã䜿çšããŸãïŒçŸåšã®ãã©ã³ããšãªããžããªã®ããã©ã«ããã©ã³ããããã³ã¯ãŒãã³ã°ããªãŒã®æªã³ãããããã³ã¹ããŒãžããã倿Žã§ãã
ãã®ã³ãã³ã㯠v2.1.147 ããå㯠/simplify ãšããååã§ãããã©ã«ãã§ä¿®æ£ãé©çšããŠããŸããã{/* min-version: 2.1.154 */}v2.1.154 ããã/simplify ã¯ãã°ãæ¢ããã«ä¿®æ£ãé©çšããã¯ãªãŒã³ã¢ããã®ã¿ã®ã¬ãã¥ãŒãå®è¡ããŸãããã°æ€åºã®ããã« /simplify ãã¹ã¯ãªããåããå Žåã¯ã倿ŽãããŠããªã /code-review --fix ã«åãæ¿ããŠãã ããã
é¢é£ãªãœãŒã¹
Code Review 㯠Claude Code ã®æ®ãã®éšåãšé£æºããããã«èšèšãããŠããŸããPR ãéãåã«ããŒã«ã«ã§ã¬ãã¥ãŒãå®è¡ãããå Žåãèªå·±ãã¹ãåã»ããã¢ãããå¿
èŠãªå ŽåããŸã㯠CLAUDE.md ãããŒã«å
šäœã§ Claude ã®åäœãã©ã®ããã«åœ¢æãããã«ã€ããŠããã«è©³ããç¥ãããå Žåããããã®ããŒãžã¯æ¬¡ã®è¯ã忢ç¹ã§ãïŒ
- Commands: ããŒã«ã«ã® Claude Code ã»ãã·ã§ã³ã§
/code-reviewãå®è¡ããŠãããã·ã¥åã«å·®åããã§ã㯠- GitHub Actions: ã³ãŒãã¬ãã¥ãŒãè¶ ããã«ã¹ã¿ã èªååã®ããã®ç¬èªã® GitHub Actions ã¯ãŒã¯ãããŒã§ Claude ãå®è¡
- GitLab CI/CD: GitLab ãã€ãã©ã€ã³çšã®èªå·±ãã¹ãå Claude çµ±å
- Memory: Claude Code å
šäœã§
CLAUDE.mdãã¡ã€ã«ãã©ã®ããã«æ©èœããã - Analytics: ã³ãŒãã¬ãã¥ãŒãè¶ ãã Claude Code 䜿çšç¶æ³ã远跡