ç®æ¬¡ (6)
æ¡åŒµåã³ãŒãã£ã³ã°ãšã¯ïŒ
æ¡åŒµåã³ãŒãã£ã³ã°ïŒAugmented CodingïŒã¯ããã€ãã³ãŒãã£ã³ã°ïŒVibe CodingïŒãè¶ ããæ¬¡ã®æ®µéã®ã³ãŒãã£ã³ã°æ¹åŒã§ãTDDã®æš©åšã§ããã±ã³ãã»ããã¯å è²Žãææ¡ããçšèªã§ãããã€ãã³ãŒãã£ã³ã°ã¯ãéçšãé£ã°ããŠçµæã ããAIã«æ±ããã³ãŒãã£ã³ã°æ¹åŒã ãšèšããŸããããã ãã®æ¹åŒã§ã¯ãã³ãŒããåãããã«ã¯ã§ããŠãããããŠãäžèŠãªããžãã¯ãããããå ¥ã蟌ã¿ãã³ãŒãã®è€éããäžãã£ãŠããŸããŸãã
æ¡åŒµåã³ãŒãã£ã³ã°ã¯ãããããªã³ãŒãã宿ãããããšãç®æšã«ããŸãã ã·ã¹ãã ã®æ¯ãèãã ããæ°ã«ãããã€ãã³ãŒãã£ã³ã°ãšã¯éããæ¡åŒµåã³ãŒãã£ã³ã°ã¯ã³ãŒãã®å質ã«ãæ°ãé ããŸããããã«è€éãããã¹ãã«ãã¬ããžã«ãç®ãé ããéçºè ãäž»å°æš©ãæã£ãŠAIãæŽ»çšããããšã§ãããè¯ãææç©ãçã¿åºããçç£æ§ãé«ããã³ãŒãã£ã³ã°ã§ãã
1. ã±ã³ãã»ããã¯ã®AIã®äœ¿ãæ¹
ã±ã³ãã»ããã¯ã¯ãç¹å¥ãªB+ããªãŒã®ã©ã€ãã©ãªãäœãã®ã«augmented codingãæŽ»çšããããã§ããã©ã®ããã«æŽ»çšããã®ãèŠãŠãããŸãããã
1.1 AIã®ã³ãŒãã£ã³ã°ãæ¢ããã¹ã3ã€ã®ãµã€ã³
ã±ã³ãã»ããã¯ã¯AIãæŽ»çšãããªãã§ãAIãããããªæ¹åã«é²ããšç©æ¥µçã«ä»å ¥ããããã§ãããããŠãAIãééã£ãŠãããµã€ã³ãšããŠ3ã€ã玹ä»ããŸããã
AIã誀ã£ãã³ãŒãã£ã³ã°ãããŠãã3ã€ã®ãµã€ã³
Loops
解決ã§ããªãåé¡ã®ããã§ãç¡éã«ãŒãã®ããã«åãè¡åãç¹°ãè¿ãå Žå
Functionality I hadn't asked for (even if it was a reasonable next step)
é Œãã§ããªãæ©èœãåæã«å®è£ ãå§ããå Žå
Any indication that the genie was cheating, for example by disabling or deleting tests
åé¡ã解決ããããã«ãºã«ïŒãã¹ãã®åé€ãç¡å¹åïŒãããå Žå
çµå±ã¯äººããã¶ã€ã³ãããšããã«ã·ã¹ãã ãæ§ç¯ããªããã°ãªããªãã®ã§ãäž»å°æš©ã¯äººãæã¡ãAIã¯çްããªåé¡ïŒãããµããã³ãŒããæžãããšãªã©ïŒã解決ããŠãããååããŒã«ã«ãªããšããããšã§ããã€ãŸããã·ã¹ãã ã®æ¬è³ªããã¶ã€ã³ããããšãããéçºè ã®æ¬è³ªã§ãããããã«éäžã§ããããã«ãªããªããã°ãªããŸããã
1.2 AIã®ããã®MDæç€ºæž
ãããŠã±ã³ãã»ããã¯ã¯ãTDDãšããããªã³ãŒãã®ããã«ããããã®MDããã¥ã¡ã³ããæŽ»çšããŠããŸããAIã«æã蟌ãããã®ãã®ã ãšèããã°ããã§ãããã以äžã«ãããããããæç€ºæžã®äžããæãæåãªãã®ã1ã€æã£ãŠããŸãããïŒã±ã³ãã»ããã¯å 貎ã®B+Treeã®æ GitïŒãè±èªã®åæãšGPTã«ããç¿»èš³ãæ·»ä»ããŸããã±ã³ãã»ããã¯ã®çµéšããã£ã·ãè©°ã蟌ãŸããããŒã¯ããŠã³ãªã®ã§ã¯ãªãããšæããŸãããTidy First?ãã®æ¬ããã€ãèªãŸãªããã°ã
CLAUDE.mdåžžã«plan.mdã®æç€ºã«åŸã£ãŠãã ãããç§ã"go"ãšèšã£ãããplan.mdã§ãŸã åŠçãããŠããªã次ã®ãã¹ããèŠã€ããŠãã®ãã¹ããå®è£
ãããã®ãã¹ããéãããã«å¿
èŠãªæå°éã®ã³ãŒãã ããæžããŠãã ããã# 圹å²ãšå°éæ§ããªãã¯ãKent Beckã®ãã¹ãé§åéçº(TDD)ãšTidy Firstã®ååã«åŸãã·ãã¢ãœãããŠã§ã¢ãšã³ãžãã¢ã§ããç®æšã¯ããã®æ¹æ³è«ãæ£ç¢ºã«å®ããªããéçºãé²ããŠããããšã§ãã# äžæ žãšãªãéçºåå- åžžã«TDDãµã€ã¯ã«ã«åŸã: Red â Green â Refactor- æãåçŽãªã倱æãããã¹ããå
ã«æžã- ãã¹ããéãããã«å¿
èŠãªæå°éã®ã³ãŒãã ããæžã- ãã¹ããéã£ãåŸã«ã®ã¿ãªãã¡ã¯ã¿ãªã³ã°ãã- Beckã®"Tidy First"ã¢ãããŒãã«åŸããæ§é çãªå€æŽãšæ¯ãèãã®å€æŽãåãã- éçºã®å
šéçšã§é«ãã³ãŒãå質ãç¶æãã# TDDæ¹æ³è«ã¬ã€ã- å°ããªæ©èœåäœã«ã€ããŠã倱æãããã¹ããå
ã«æžã- æ¯ãèãã説æããæå³ã®ãããã¹ãåã䜿ã (äŸ: shouldSumTwoPositiveNumbers)- ãã¹ãã®å€±æã¡ãã»ãŒãžã¯æç¢ºã§ããããããæžã- ãã¹ããéãã®ã«å¿
èŠãªåã ãã³ãŒããæžã â ãã以äžã¯çŠæ¢- ãã¹ãããã¹ãŠéã£ããããªãã¡ã¯ã¿ãªã³ã°ã®å¿
èŠæ§ãæ€èšãã- æ°ããæ©èœã«ã€ããŠãã®ãµã€ã¯ã«ãç¹°ãè¿ã# Tidy Firstã¢ãããŒã- ãã¹ãŠã®å€æŽã2çš®é¡ã«åºå¥ãã:- æ§é çãªå€æŽ(Structural Changes): åäœã¯å€ããã«ã³ãŒãã®æ§é ã ããæŽçãã (ååã®å€æŽãã¡ãœããã®æœåºãã³ãŒãã®ç§»åãªã©)- æ¯ãèãã®å€æŽ(Behavioral Changes): å®éã®æ©èœã®è¿œå ãŸãã¯ä¿®æ£- åãã³ãããã§2çš®é¡ã®å€æŽãæ··ããªã- æ§é çãªå€æŽãšæ¯ãèãã®å€æŽã®äž¡æ¹ãå¿
èŠãªããåžžã«æ§é çãªå€æŽãå
ã«è¡ã- æ§é çãªå€æŽãåäœãå€ããŠããªãããšãä¿èšŒããããã倿Žã®ååŸã§ãã¹ããå®è¡ãã# ã³ãããã®èŠåŸ- æ¬¡ã®æ¡ä»¶ããã¹ãŠæºãããããšãã«ã®ã¿ã³ããããã:- ãã¹ãŠã®ãã¹ããéã£ãŠããããš- ãã¹ãŠã®ã³ã³ãã€ã©/ãªã³ã¿ãŒã®èŠåãè§£æ¶ãããŠããããš- 倿Žå
容ã1ã€ã®è«ççãªäœæ¥åäœã§ããããš- ã³ãããã¡ãã»ãŒãžã§ãæ§é çãªå€æŽãæ¯ãèãã®å€æŽããæç¢ºã«èª¬æããããš- å°ããªåäœã§é »ç¹ã«ã³ããããã倧ããªåäœã§ãŸãã«ã³ãããããªã# ã³ãŒãå質ã®åºæº- éè€ã¯åŸ¹åºçã«åãé€ã- æå³ãæç¢ºã«äŒããããã«ååãšæ§é ã§è¡šçŸãã- äŸåé¢ä¿ãæç¢ºã«ãã- ã¡ãœããã¯å°ããä¿ã¡ãåäžã®è²¬ä»»ã«éäžããã- ç¶æ
ãšå¯äœçšãæå°éã«ãã- å¯èœãªéãæãåçŽãªè§£æ±ºçã䜿ã# ãªãã¡ã¯ã¿ãªã³ã°ã®ã¬ã€ãã©ã€ã³- ãã¹ããéã£ãŠãããšãã«ã®ã¿ãªãã¡ã¯ã¿ãªã³ã°ãã (ã€ãŸãGreenã®æ®µéã§)- 確ç«ããããªãã¡ã¯ã¿ãªã³ã°ãã¿ãŒã³ã䜿ããååãæç¢ºã«ãã- äžåºŠã«1ã€ã®ãªãã¡ã¯ã¿ãªã³ã°ã ããè¡ã- ãªãã¡ã¯ã¿ãªã³ã°ã®ã¹ãããããšã«ãã¹ããå®è¡ãã- éè€ã®é€å»ãšå¯èªæ§ã®æ¹åãåªå
ãã# ã¯ãŒã¯ãããŒã®äŸæ°ããæ©èœãéçºãããšã:1. æ©èœã®å°ããªéšåã«ã€ããŠã倱æãããã¹ããæžã2. ãã®ãã¹ããéãããã«æå°éã®ã³ãŒããæžã3. ãã¹ããå®è¡ â éããã©ãããç¢ºèª (Green)4. å¿
èŠãªå Žåã¯æ§é çãªå€æŽ(Tidy First)ãè¡ãã倿Žãããã³ã«ãã¹ããå®è¡5. æ§é çãªå€æŽã¯å¥ã«ã³ããã6. 次ã®å°ããªæ©èœåäœã®ãã¹ãã远å ãã7. æ©èœã宿ãããŸã§ãã®ãµã€ã¯ã«ãç¹°ãè¿ã(æ¯ãèãã®å€æŽãšæ§é çãªå€æŽã¯ããããå¥ã«ã³ããã)Ruståºæã®æé- Rustã§ã¯åœä»€åã¹ã¿ã€ã«ãã颿°åã¹ã¿ã€ã«ã奜ã- if letãmatchã®ãã¿ãŒã³ãããã³ã°ã®ä»£ããã«ãOptionãšResultã®ã³ã³ãããŒã¿ãŒ(map, and_then, unwrap_orãªã©)ãæŽ»çšãããã®ã»ãã«ããAI AGENTãã¿ã£ã¡ãéããŠãããæç€ºæžãå ±æããŠãããµã€ãããããŸããïŒagents.mdïŒ
2. Augmented Codingã®ããã³ãããçµã
ä»åã¯ãã±ã³ãã»ããã¯ã®ããã«Augmented Codingã®ããã³ãããçµãã§ã¿ãŸããããããã³ããã¯é·ããªãããšããããŸããã§ãããæ®µéããšã«åããŠå®è¡ãããããã«ããªããã°ãªããŸãããæçš¿ãæžãå Žåãæ³å®ããŠã¿ãŸããã
æ©èœã以äžã®ããã«ãããšããŸãã
æ©èœ
ã¿ã€ãã«ãã«ããŽãªãŒãæ¬æã§æ§æãããæçš¿ã®äœæ
ã¿ã€ãã«ïŒ2ã10æåã«å¶é
ã«ããŽãªãŒïŒ2ã10æåã«å¶é
æ¬æïŒ1æå以äžãå¿ é
ä¿åãã¿ã³ã«ããæçš¿ã®ä¿å
æ€èšŒã«ãŒã«
æåæ°ãåºæºã«æºããªãå Žåã¯ãšã©ãŒã¡ãã»ãŒãžã衚瀺
éè€ããã¿ã€ãã«ãååšããå Žåã¯ãšã©ãŒã¡ãã»ãŒãžã衚瀺
ä¿åæåæïŒ"ä¿åãããŸãã" ããŒã¹ãã¡ãã»ãŒãž
ä¿å倱ææïŒ"ä¿å倱æ" ããŒã¹ãã¡ãã»ãŒãž
ã§ã¯ãäžã®æ©èœãããšã«èšèšãããŠãplan.mdã«æžããŠã¿ãŸãããã
æçš¿æ©èœã®ãã¹ãèšç» (plan.md)ãã¹ãã®é²è¡é åºåãã¹ãã¯æãå°ããªåäœããå§ããæ®µéçã«æ©èœãæ¡åŒµããŠãããŸããã±ã³ãã»ããã¯ã®ããã«Red -> Green -> Refactorã®ãµã€ã¯ã«ã§é²ããæ§é ã®å€æŽããè¡ã£ãŠããæ¯ãèãã®å€æŽãããããšãã£ãååãå®ããªããã°ãªããªãã!!ãããŠãAIãéã«è¿·ã(3ã€ã®å±éºä¿¡å·)ããã£ãŠããããããã«æ¢ããŠãã³ãã³ã«ããŠãããããŒã¯ã³ãç¡é§ã«ããã ãã ã1. æçš¿ãªããžã§ã¯ãçæã®ãã¹ã - shouldCreateEmptyPost - ç©ºã®æçš¿ãªããžã§ã¯ããçæ - shouldCreatePostWithValidData - æå¹ãªããŒã¿ã§æçš¿ãçæ2. ã¿ã€ãã«æ€èšŒã®ãã¹ã - shouldRejectTitleWithLessThan2Characters - 1æå以äžã®ã¿ã€ãã«ãæåŠ - shouldRejectTitleWithMoreThan10Characters - 10æåãè¶
ããã¿ã€ãã«ãæåŠ - shouldAcceptTitleWith2Characters - 2æåã®ã¿ã€ãã«ãèš±å¯ - shouldAcceptTitleWith10Characters - 10æåã®ã¿ã€ãã«ãèš±å¯ - shouldAcceptTitleWithValidLength - 2ã10æåã®ã¿ã€ãã«ãèš±å¯3. ã«ããŽãªãŒæ€èšŒã®ãã¹ã - shouldRejectCategoryWithLessThan2Characters - 1æå以äžã®ã«ããŽãªãŒãæåŠ - shouldRejectCategoryWithMoreThan10Characters - 10æåãè¶
ããã«ããŽãªãŒãæåŠ - shouldAcceptCategoryWith2Characters - 2æåã®ã«ããŽãªãŒãèš±å¯ - shouldAcceptCategoryWith10Characters - 10æåã®ã«ããŽãªãŒãèš±å¯ - shouldAcceptCategoryWithValidLength - 2ã10æåã®ã«ããŽãªãŒãèš±å¯4. æ¬ææ€èšŒã®ãã¹ã - shouldRejectEmptyContent - ç©ºã®æ¬æãæåŠ - shouldAcceptContentWith1Character - 1æåã®æ¬æãèš±å¯ - shouldAcceptContentWithMultipleCharacters - è€æ°æåã®æ¬æãèš±å¯5. éè€ã¿ã€ãã«æ€èšŒã®ãã¹ã - shouldAllowFirstPostWithTitle - æåã®æçš¿ã®ã¿ã€ãã«ãèš±å¯ - shouldRejectDuplicateTitle - éè€ããã¿ã€ãã«ãæåŠ - shouldAllowSameTitleAfterDeletion - åé€åŸã®åãã¿ã€ãã«ãèš±å¯6. æçš¿ä¿åã®ãã¹ã - shouldSaveValidPost - æå¹ãªæçš¿ã®ä¿åã«æå - shouldReturnSuccessMessageOnSave - ä¿åæåæã«"ä¿åãããŸãã"ã¡ãã»ãŒãž - shouldReturnErrorMessageOnSaveFailure - ä¿å倱ææã«"ä¿å倱æ"ã¡ãã»ãŒãž7. ãã©ãŒã æ€èšŒã®çµ±åãã¹ã - shouldShowErrorForInvalidTitle - äžæ£ãªã¿ã€ãã«ã®å
¥åæã«ãšã©ãŒã衚瀺 - shouldShowErrorForInvalidCategory - äžæ£ãªã«ããŽãªãŒã®å
¥åæã«ãšã©ãŒã衚瀺 - shouldShowErrorForInvalidContent - äžæ£ãªæ¬æã®å
¥åæã«ãšã©ãŒã衚瀺 - shouldShowErrorForDuplicateTitle - éè€ããã¿ã€ãã«ã®å
¥åæã«ãšã©ãŒã衚瀺8. UIã³ã³ããŒãã³ãã®ãã¹ã - shouldRenderPostForm - æçš¿äœæãã©ãŒã ã®ã¬ã³ããªã³ã° - shouldRenderTitleInput - ã¿ã€ãã«å
¥åãã£ãŒã«ãã®ã¬ã³ããªã³ã° - shouldRenderCategoryInput - ã«ããŽãªãŒå
¥åãã£ãŒã«ãã®ã¬ã³ããªã³ã° - shouldRenderContentTextarea - æ¬æå
¥åãšãªã¢ã®ã¬ã³ããªã³ã° - shouldRenderSaveButton - ä¿åãã¿ã³ã®ã¬ã³ããªã³ã°9. ãŠãŒã¶ãŒã€ã³ã¿ã©ã¯ã·ã§ã³ã®ãã¹ã - shouldUpdateTitleOnInput - ã¿ã€ãã«å
¥åæã«ç¶æ
ãæŽæ° - shouldUpdateCategoryOnInput - ã«ããŽãªãŒå
¥åæã«ç¶æ
ãæŽæ° - shouldUpdateContentOnInput - æ¬æå
¥åæã«ç¶æ
ãæŽæ° - shouldTriggerSaveOnButtonClick - ä¿åãã¿ã³ã®ã¯ãªãã¯æã«ä¿ååŠçãå®è¡10. ããŒã¹ãã¡ãã»ãŒãžã®ãã¹ã - shouldShowSuccessToastOnSuccessfulSave - ä¿åæåæã«æåããŒã¹ã - shouldShowErrorToastOnFailedSave - ä¿å倱ææã«å€±æããŒã¹ã - shouldHideToastAfterDelay - äžå®æéåŸã«ããŒã¹ããèªåã§é衚瀺ãã¹ãã®é²è¡ã«ãŒã«äžããé çªã«é²ããåãã¹ãããšã«ãã§ãã¯ããã¯ã¹[ ]ã[x]ã«å€æŽããŠå®äºã衚瀺äžåºŠã«1ã€ã®ãã¹ãã ããå®è£
æ¢åã®ãã¹ãããã¹ãŠéã£ãç¶æ
ã§æ¬¡ã®ãã¹ãã«é²ããªãã¡ã¯ã¿ãªã³ã°ã¯ãã¹ããéã£ãåŸã«ã®ã¿è¡ããããŠãäžã®plan.mdãAIã«æž¡ããŠãç§ãããã³ããã«ãgoããšå«ã¹ã°ãããã³ãããæ®µéçã«åŠçããŠãããã¯ãã§ãããšããããé²ããŠãããã¡ã«ãããªããŒã·ã§ã³ããã®éœåºŠãå¿ èŠã«ãªããã³ã«äœã£ãŠããŸã£ãŠããŸããã§ã¯ãã©ãããã°ããã§ããããïŒïŒäœã£ãŠãããValidatorãªããžã§ã¯ããæŽ»çšããããã«mdæç€ºæžãè£åŒ·ããã®ãããããã§ãããã ããã®æç€ºã¯å šäœã«é¢ããæç€ºã§ã¯ãªããšå€æããŸãããå¥ã®mdãšããŠäœãã®ãããããã§ããïŒã³ã³ããã¹ããäžåºŠã«ããããå ¥ãããšããéããã£ãšããããŸã!! ããŒã¯ã³ãç¯çŽããªããæå€§ã®å¹çãåºããŸãããïŒ
VALIDATOR.mdããŸãã¯FORM_GUIDE.mdFormãéçºãããšãã«åŸãã¹ãã«ãŒã«ãã£ãŒã«ãå®çŸ© â Validatoræ¥ç¶ â UI衚瀺ã®é åºãµã³ãã«ã³ãŒã (ã·ã³ãã«ãªInput + Validatorã®çµã¿åãã)"Formã®å
éšã§çŽæ¥æ¡ä»¶æã䜿ã£ãŠããªããŒã·ã§ã³ããªãããš""Validatorãªããžã§ã¯ãã«ãªãæ€èšŒã¯ã远å ããŠãã䜿ãããš"äŸ:const TitleValidator = Validator.string() .min(2, "ã¿ã€ãã«ã¯æäœ2æå以äžã§ããå¿
èŠããããŸãã") .max(10, "ã¿ã€ãã«ã¯æå€§10æåãŸã§å¯èœã§ãã");ããã§ãã®FORM_GUIDE.mdã¯ãFormã®ããªããŒã·ã§ã³ãå¿ èŠãªãšãã¯ããã³ããã«äžç·ã«æ·»ä»ããããã§ãªããã°æ·»ä»ããã«äœ¿ãã°OKã§ãã
3. ãŸãšã
ä»ã®æä»£ããã¹ãŠã®éçºè ãæ±ããŠããæ©ã¿ããããŸããããã¯AIã«ã€ããŠã®æ©ã¿ã§ããææãããããªãããããé«ãçç£æ§ã楜ããã§ãããããããªãããæã¯ã³ãŒããæžãã®ã楜ããã£ãã®ã«ã¡ã¿ãå€ãã£ãŠæãã€ã«ãªã£ãŠãããããããªããããããããªæããå ¥ãæ··ãã£ãæ©ã¿ãæ±ããŠããããšã§ããããã©ã®è·çš®ãããæåç·ã§äœ¿ãããã®æé·ãç®ã®åœããã«ããŠãããããããããå€ãã®æ©ã¿ãæ±ããã®ã ãšæããŸããã§ãã奜ããšå¥œãŸãããšã«ããããããä»ãã®æä»£ã«ã¯ãAIãããŸã掻çšã§ããªããã°ãªããªãããã§ãããããŠAIãããŸã掻çšããã«ã¯ãèšèšãšãã¶ã€ã³ããã£ããã§ããªããã°ãªããªãæä»£ããã§ã«æ¥ãŠããããã§ãããã®æä»£ãããã«éãå»ããæ¬åœã«ããäžæ¡ãã®å€©æã ããå¿ èŠãšãããæä»£ãæ¥ããããããŸããããä»ã¯ä»ãªãã«é©å¿ããŠãããªããã°ãªããªããšæããŸãã
åèè³æ
