ð Issueããªãã³åéçºã§æ確ãªé²æ管çãå®çŸãã
ãœãããŠã§ã¢éçºãåæ»ã«é²ããããã§ãã¿ã¹ã¯ç®¡çã¯æ¬ ãããŸãããç¹ã«ãè€æ°äººãé¢ãããããžã§ã¯ãã§ã¯ã誰ãäœã«åãçµãã§ããããã©ããªç¶æ ã§ããããæ確ã«ææ¡ããå¿ èŠããããŸããããã§æ³šç®ãããã®ããIssueããªãã³åéçºãã§ãã
æ¬èšäºã§ã¯ãIssueããªãã³åéçºã®æŠèŠãããã®ç¹åŸŽãIssueã®æžãæ¹ãããã«ã¯å®éã«ããå©çšãããããŒã«ãããµãã¿ã¹ã¯ã掻çšããã¯ãªãã£ã«ã«ãã¹ã®å¯èŠåæ¹æ³ãŸã§ã玹ä»ããŸãã
1. Issueããªãã³åéçºãšã¯ ð§
Issueããªãã³åéçºãšã¯ãéçºã«ãããäœæ¥åäœïŒã¿ã¹ã¯ïŒããIssueããšããŠå®çŸ©ã»ç®¡çãããã®Issueãäžå¿ã«é²è¡ãã³ã³ãããŒã«ããéçºææ³ã§ãããããžã§ã¯ã管çããŒã«äžã§ä»¥äžã®æµãã確ç«ããŸãã
- ãäœããããã€ãŸã§ã«ãããªããããã¹ãããIssueã«èœãšã蟌ã
- æ åœè å²åœãæéèšå®ãã©ããªã³ã°ã¯ããŒã«æ©èœã掻çšïŒIssueæ¬æã«ã¯æžããªãïŒ
- Issueãæ¶åããããšã§é²æããã¬ãŒãµããªãã£ãæ確ã«ãªããåŸããã®åç §ã»åæã容æã«
ãã®ææ³ã«ãããããŒã å šå¡ãåãèŠç¹ã§ã¿ã¹ã¯ãæ±ããããã«ãªããåæ»ãªã³ãã¥ãã±ãŒã·ã§ã³ãšè¿ éãªææ決å®ããµããŒãããŸãã
2. Issueããªãã³ã®ç¹åŸŽ ð¯
-
ã¿ã¹ã¯ã®æ確åïŒ
Issueã¯ãäœããã¹ããããæ確ã«å®çŸ©ããŽãŒã«ãæ確ã§ãéçºè ã¯è¿·ããçæã§ããŸãã -
ææ¥ã»æ åœè ã®å¯èŠåïŒ
ããŒã«äžã§æéãæ åœè ãèšå®ããããšã§ã誰ããã€ãŸã§ã«äœãããããã¯ãªã¢ã«ãªããŸãã -
ãã¬ãŒãµããªãã£ç¢ºä¿ïŒ
è°è«ã決å®çµç·¯ãé¢é£ãœãŒã¹ã³ãŒããããã¥ã¡ã³ããIssueåäœã§è¿œè·¡å¯èœãåŸããã®æ¯ãè¿ããæ¹åç¹æœåºã容æã -
é²æ管çã®å®¹æåïŒ
å®äºããIssueæ°ãæ®ã¿ã¹ã¯æ°ãããŒã¹ã«ãPM/ãªãŒããŒãé²æãå®éçã«ææ¡ã§ããŸãã
3. Issueããªãã³ã®ã¡ãªãããšçã âš
éçºè ç®ç·ïŒ
- åãå ¥ãæ¡ä»¶ãæ確ã§ãDoneãã®å®çŸ©ãæç
- ãµãã¿ã¹ã¯ã§å€§ããªã¿ã¹ã¯ãå解ãã䞊åäœæ¥ããããããããã«ããã¯æœåºã容æ
PM/ãªãŒããŒç®ç·ïŒ
- IssueãKPIåãããããžã§ã¯ãé²è¡åºŠåããæ°å€ã§ææ¡å¯èœ
- æ©æã®åé¡çºèŠã»ãªã¹ã¯ç®¡çã容æã«ãªããã¹ã±ãžã¥ãŒã«èª¿æŽãã¹ã ãŒãº
4. Issueã®æžãæ¹äŸ ð
以äžã¯Issueæ¬æã®ãµã³ãã«äŸã§ãã
æéãæ
åœè
ãã©ãã«ãªã©ã¯ããŒã«äžã§èšå®ããããã«ã¯æžããã«ãå®è£
ãã¹ãå
容ãåãå
¥ãæ¡ä»¶ãªã©ã®æ¬è³ªçæ
å ±ãšãåèè³æïŒãœãŒã¹ã³ãŒããªã³ã¯ãä»æ§ããã¥ã¡ã³ããªã³ã¯ïŒãèšèŒããŸãã
## ð¯ ã¿ã€ãã« (Summary)
ãŠãŒã¶ç»é²ç»é¢ã§ã¡ãŒã«ã¢ãã¬ã¹éè€ãã§ãã¯ãå®è£
ãã
## ð 説æ (Description)
ãŠãŒã¶ç»é²æã«ãåäžã¡ãŒã«ã¢ãã¬ã¹ã§è€æ°ã¢ã«ãŠã³ããäœæãããªãããã«éè€ãã§ãã¯ãè¡ãã
- éè€ã¢ãã¬ã¹ã®å Žåã¯ç»é²ãæåŠãããšã©ãŒè¡šç€º
- ãšã©ãŒã¡ãã»ãŒãž: "ãã®ã¡ãŒã«ã¢ãã¬ã¹ã¯æ¢ã«ç»é²ãããŠããŸã"
## â
åãå
¥ãæ¡ä»¶ (Acceptance Criteria)
- æ¢åã¢ã«ãŠã³ãã§å©çšäžã®ã¡ãŒã«ã¢ãã¬ã¹ãæ°èŠç»é²æã«äœ¿çšããå Žåããšã©ãŒã衚瀺ããã
- ãšã©ãŒã¡ãã»ãŒãž: "ãã®ã¡ãŒã«ã¢ãã¬ã¹ã¯æ¢ã«ç»é²ãããŠããŸã" ãæ£ãã衚瀺ããã
- æ£åžžç³»ïŒéè€ããªãå Žåãæ£åžžã«ã¢ã«ãŠã³ããäœæããã
## ð åèãªã³ã¯ (References)
- é¢é£ãœãŒã¹ã³ãŒã: [GitHub ãªããžããªã®ãŠãŒã¶ã¢ãã«å®çŸ©](https://github.com/exampleorg/project/blob/main/models/user.go)
- ä»æ§ããã¥ã¡ã³ã: [ãŠãŒã¶ç»é²æ©èœä»æ§æž (Confluence)](https://confluence.example.com/display/PROJ/User+Registration+Specs)
- APIä»æ§: [OpenAPIããã¥ã¡ã³ã](https://api.example.com/swagger)
ãã®ããã«ãé¢é£ãœãŒã¹ã³ãŒããžã®ãªã³ã¯ãèšèšããã¥ã¡ã³ããä»æ§æžãžã®ãªã³ã¯ãèšèŒããŠãããšãéçºè ã¯IssueãèŠãã ãã§é¢é£æ å ±ãžã¹ã ãŒãºã«ã¢ã¯ã»ã¹ã§ããã¿ã¹ã¯éè¡ãå¹çåããŸãã
5. ã©ããªã³ã°ããµãã¿ã¹ã¯ããšããã¯åã§ãã匷åã« ð
-
ã©ããªã³ã°ïŒ
ãããžã§ã¯ã管çããŒã«ã®ã©ãã«æ©èœã§"bug"ã"feature"ã"frontend"ã"backend"ãªã©ãèšå®ããç¹å®é åã®Issueãç°¡ææœåºã -
ãµãã¿ã¹ã¯åïŒ
ãšããã¯ïŒå€§ããªæ©èœïŒãè€æ°ã®ãµãã¿ã¹ã¯ã«åå²ããå®è£ ãã¬ãã¥ãŒããã¹ããèšèšãªã©ã现ååã»å¯èŠåã
äŸåé¢ä¿ãæ確ã«ãªããã䞊åäœæ¥ãã¹ã ãŒãºã -
ãšããã¯åïŒEpicïŒïŒ
倧èŠæš¡ãªæ©èœçŸ€ããšããã¯ãšããŠéçŽããäžäœã®Issue矀ã§å šäœåãææ¡ãããŒããããäžã§å šã¿ã¹ã¯ãé³¥ç°ã§ããã
6. Issueãšã³ããããPRã®çŽä»ãã§ãã¬ãŒãµããªãã£åŒ·å ð
- ã³ãããã¡ãã»ãŒãžãPR説æã«Issueçªå·ãæ¿å ¥ïŒäŸ: "Fixes #123"ïŒ
- å€æŽå±¥æŽã®èæ¯ãIssueåäœã§ãã¬ãŒã¹ã§ããåŸããã®çç±ç¢ºèªãæ¹å掻åã容æå
7. ããå©çšãããIssue管çããŒã«äŸ ð
- GitHub IssuesïŒGitHubãšçµ±åãProjectsã§ã®ã«ã³ãã³ç®¡çãå¯èœ
- GitLab IssuesïŒGitLabãšçµ±åãEpicsãLabelsãªã©æè»ãªç®¡çæ©èœ
- JiraïŒã¢ãžã£ã€ã«éçºç¹åããšããã¯ã»ã¹ããªã³ãã»ããŒã³ããŠã³ãã£ãŒããªã©è±å¯ãªæ©èœãSlacké£æºãªã©ãã»ãŒæšæºã§å¯èœ
- AsanaïŒçŽæçãªUIãéçºä»¥å€ã®æ¥åã¿ã¹ã¯ç®¡çã«ã察å¿å¯
ã©ã®ããŒã«ãå€ãã®ã€ã³ãã°ã¬ãŒã·ã§ã³ïŒSlackãCI/CDããŒã«ãªã©ïŒã«å¯Ÿå¿ããŠããããªã¢ã«ã¿ã€ã ãªéç¥ã»ã³ã©ãã¬ãŒã·ã§ã³ãå¯èœã§ãã
çªå€ç·šïŒãµãã¿ã¹ã¯ã§ã¯ãªãã£ã«ã«ãã¹ãå¯èŠåãã ð
ãµãã¿ã¹ã¯åã«ãããèšèšãå®è£
ãã¬ãã¥ãŒããã¹ããªã©å·¥çšå
šäœã现ååã§ããŸãã
ãããã¿ã¹ã¯éã®äŸåé¢ä¿ãæ確ã«ãããšãã¯ãªãã£ã«ã«ãã¹ïŒé
延ãå
šäœåœ±é¿ããéèŠã¿ã¹ã¯çŸ€ïŒãèŠãããããªããŸãã
ããŒã«äžã§ã®ããŒããããã»ã¬ã³ããã£ãŒãã§å¯èŠåããã»ãã以äžã®ãããªMermaidèšæ³ã§äŸåé¢ä¿å³ãæãããšãå¯èœã§ãã
ãã®ãããªèŠèŠåãè£å©çã«äœ¿ãããšã§ãPMã¯ç¹ã«æ³šæãã¹ãã¿ã¹ã¯ïŒã¯ãªãã£ã«ã«ãã¹äžã®ã¿ã¹ã¯ïŒã«ãã©ãŒã«ã¹ãããªãœãŒã¹åé åãåªå 床調æŽãè¡ããŸãã
ãŸãšã ð
Issueããªãã³åéçºã¯ãæ確ãªã¿ã¹ã¯å®çŸ©ãšãã¬ãŒãµããªãã£ã確ç«ãããããžã§ã¯ããã¹ã ãŒãºã«é²è¡ãããæåãªã¢ãããŒãã§ããæ åœè å²åœãæéèšå®ãã©ããªã³ã°ãªã©ã¯ããŒã«æ©èœã«å§ããIssueæ¬æã«ã¯ä»æ§ã»èŠä»¶ã»åèãªã³ã¯ãªã©æ¬è³ªæ å ±ãéçŽãããšéçšãå¹çåããŸãã
ãŸãããµãã¿ã¹ã¯åããšããã¯åã§éå±€çãªç®¡çãè¡ããã¯ãªãã£ã«ã«ãã¹ãå¯èŠåããã°ããªã¹ã¯åé¿ãã¹ã±ãžã¥ãŒã«èª¿æŽãç確ã«è¡ãããšãã§ããŸããIssueããœãŒã¹ã³ãŒããããã¥ã¡ã³ããããŒã«ãçµã¿åãããã°ãããŒã ã¯æ確ãªéããã¹ã«åŸã£ãŠå質ã®é«ãææãå¹ççã«çã¿åºããã§ãããã
Discussion