ð« Toolkit to help you get started with SDD or any other process!
ð± Spec Kit
仿§ã§äœãããã°ãçŽããã¢ã€ãã¢ãèŠæ¥µãã ââ ããªãã®ã³ãŒãã£ã³ã°ãšãŒãžã§ã³ããšå ±ã«ã
English · ç®äœäžæ · æ¥æ¬èª · íêµìŽ
Spec Kitã¯ãAIã³ãŒãã£ã³ã°ãšãŒãžã§ã³ãã«æ§é åãããããã»ã¹ãåå©çšå¯èœãªãã³ãã¬ãŒããèšé²ã«æ®ãææããããããªãŒãã³ãœãŒã¹ã®ããŒã«ãããã§ãã以äžã®3ã€ã®ããã»ã¹ã®ããããããå§ããå¿ èŠã«å¿ããŠã«ã¹ã¿ãã€ãºããããèªåèªèº«ã®ããã»ã¹ãæã¡èŸŒãã ãããããšãã§ããŸãã
å©çšããããã»ã¹ãéžæãã
| ããããããš | ããã»ã¹ | ææ |
|---|---|---|
| æ©èœãã¢ããªã±ãŒã·ã§ã³ãæ§ç¯ãã | 仿§é§åéçº | èšç»ã»å®è£ ã»åæãŸã§äžè²«ããŠæŽ»çšããã仿§ |
| äžå ·åã®ããåäœã蚺æããä¿®æ£ãã | ãã°ä¿®æ£ | è©äŸ¡ãããåå ãç¯å²ãçµã£ãä¿®æ£ãèšé²ãããæ€èšŒ |
| ã¢ã€ãã¢ã«æè³ãã䟡å€ãããã倿ãã | ã¢ã€ãã¢è©äŸ¡ | æ ¹æ ã«åºã¥ããé²ãã(go)ã»èŠç¢ºèªã»äžæ¢ã®ããããã®æ±ºå® |
ãããã¯ç¬ç«ãããšã³ããªãŒãã€ã³ãã§ãããå¿ ãé çªã«å®æœãã3段éã®ãã§ãŒãºã§ã¯ãããŸãããSDDã¯ã³ã¢ã«å梱ãããŠããŸãããã°ä¿®æ£ãšã¢ã€ãã¢è©äŸ¡ã¯ãå¿ èŠãªãšãã«ã€ã³ã¹ããŒã«ãããã³ãã«æ¡åŒµæ©èœã§ãã
ã¯ããã
LinuxãmacOSããŸãã¯Windowsäžã§ãPython 3.11以éãuvãããã³å¯Ÿå¿ããAIã³ãŒãã£ã³ã°ãšãŒãžã§ã³ããå¿ èŠã§ãã CLIã®ã¿ã®ã»ããã¢ãããè¡ãå Žåã¯ãã¿ãŒããã«ã§ä»¥äžã®ã³ãã³ããå®è¡ããŠSpec Kitãã€ã³ã¹ããŒã«ãããããžã§ã¯ããäœæããŠãã ãã:
uv tool install specify-cli
specify init my-project --integration copilot
cd my-project
ãã®äŸã§ã¯ GitHub Copilotã®ããã©ã«ãã®ã¹ãã«ã¢ãŒã ã䜿çšããŠããŸããä»ã®å¯Ÿå¿ãšãŒãžã§ã³ãã䜿ãå Žåã¯ãcopilot ãã䜿ãã®ãšãŒãžã§ã³ãã®é£æºããŒã«çœ®ãæããŠãã ããã
ãã§ã«ã³ãŒãããããŸããïŒæ¢åãããžã§ã¯ãåãã¬ã€ããåç §ããŠãã ãããããŒãžã§ã³åºå®ã§ã®ã€ã³ã¹ããŒã«ããã®ä»ã®ã€ã³ã¹ããŒã©ãŒãCIããã©ãã«ã·ã¥ãŒãã£ã³ã°ã«ã€ããŠã¯ã€ã³ã¹ããŒã«ã¬ã€ãããæ¢åã®ã€ã³ã¹ããŒã«ãæŽæ°ããå Žåã¯ã¢ããã°ã¬ãŒãã¬ã€ããåç §ããŠãã ããã
ãããããããžã§ã¯ããã£ã¬ã¯ããªã§ã³ãŒãã£ã³ã°ãšãŒãžã§ã³ããèµ·åããäžèšã®ããããã®ããã»ã¹ãéžãã§ãã ãããå /speckit-* ã¹ãã«ã¯ãšãŒãžã§ã³ãã®ãã£ããå
ã§ã1ã€ãã€åŒã³åºããçµæã確èªããŠããæ¬¡ã«é²ãã§ãã ããããããã¯ã¿ãŒããã«ã³ãã³ãã§ã¯ãªãããšãŒãžã§ã³ãã®ã¹ãã«ã§ãããšãŒãžã§ã³ããã¢ãŒãã«ãã£ãŠã¯ãç°ãªãåŒã³åºãæ¹ã䜿ãå ŽåããããŸãã
仿§é§åéçº
äœã æ¹æ³(how) ãæ±ºããåã«ã äœã(what)ã»ãªã(why) ãå®çŸ©ããŸããSDDã¯èŠä»¶ã仿§ã»æè¡èšç»ã»å®è¡å¯èœãªã¿ã¹ã¯ãžãšå€æãããããã®ææç©ã«æ²¿ã£ãŠå®è£ ãå°ããŸãã
ãããžã§ã¯ãããšã«äžåºŠã ãå šäœã«ãŒã«(constitution)ãå®ããæ©èœããšã« 仿§å(specify) â èšç»(plan) â ã¿ã¹ã¯å(tasks) â å®è£ (implement) â åæ(converge) ãè¡ããŸãã
ãšãŒãžã§ã³ãã®ãã£ããã§ã以äžã®ã¹ãã«ãåŒã³åºããŸã:
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge
åæçµæã Converged ãšå ±åããããŸã§ãimplement â converge ãç¹°ãè¿ããŸãã远å ã®å質ã²ãŒããå¿ èŠãªå Žåã¯ãæç¢ºåã»ãã§ãã¯ãªã¹ãã»äžè²«æ§åæãå ããŠãã ããã
SDDå®è·µã¬ã€ã · ã³ãã³ããªãã¡ã¬ã³ã¹
ãã°ä¿®æ£
蚺æã»ä¿®åŸ©ã»æ€èšŒãåããŠããããšã§ããšãŒãžã§ã³ããè©äŸ¡æžã¿ã®åå ãä¿®æ£ããå ã®çç¶ãè§£æ¶ããããã確èªã§ããããã«ããŸããäºåã«SDDã®æ©èœéçºã¯ãŒã¯ãããŒãè¡ãå¿ èŠã¯ãããŸããã
CLIã»ããã¢ãã(ã¿ãŒããã«): ãããžã§ã¯ããã£ã¬ã¯ããªã§ãªããã€ã³æ¹åŒã®æ¡åŒµæ©èœãã€ã³ã¹ããŒã«ããŸã:
specify extension add bug
次ã«ããšãŒãžã§ã³ãã®ãã£ããã§ è©äŸ¡(assess) â ä¿®æ£(fix) â ãã¹ã(test) ã®ã¹ãã«ãåŒã³åºããŸã:
/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash
ã¬ããŒã㯠.specify/bugs/login-crash/ ã«ä¿åãããŸããæçµçãªå€å®ã確èªããŠãã ããã
verified(æ€èšŒæžã¿)ãpartial(éšåç)ãfailed(倱æ)ã®ããããã§ããæ€èšŒããªããã®ã¯ä¿®æ£ãæåãããšã¯èšããŸããã
ãã°ä¿®æ£å®è·µã¬ã€ã · ã³ãã³ããªãã¡ã¬ã³ã¹
ã¢ã€ãã¢è©äŸ¡
ãã®ã¢ã€ãã¢ããœãããŠã§ã¢ã«ãªããã©ããã«ããããããã¢ã€ãã¢ãé²ãããšæ±ºããåã«æ ¹æ ãéããŸãããã®ç¬ç«ããããã»ã¹ã¯ããœãŒã¹ã³ãŒããååšããªããããžã§ã¯ãã§ãæ©èœããŸãã
CLIã»ããã¢ãã(ã¿ãŒããã«): ãããžã§ã¯ããã£ã¬ã¯ããªã§ãªããã€ã³æ¹åŒã®æ¡åŒµæ©èœãã€ã³ã¹ããŒã«ããŸã:
specify extension add assess
次ã«ããšãŒãžã§ã³ãã®ãã£ããã§ åä»(intake) â 調æ»(research) â å®çŸ©(define) â å ·äœå(shape) â æ±ºå®(decide) ã®ã¹ãã«ãåŒã³åºããŸã:
/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
/speckit-assess-research slug=offline-mode
/speckit-assess-define slug=offline-mode
/speckit-assess-shape slug=offline-mode
/speckit-assess-decide slug=offline-mode
ææç©ã¯ .specify/assessments/offline-mode/ ã«ä¿åãããæçµçã«
é²ãã(go)ã»èŠç¢ºèª(needs-clarification)ã»äžæ¢(kill) ã®3æã§çµè«ãåºãŸããäžæç¹ãè§£æ¶ããã«ã¯ãã¹ããŒãžå
šäœãåçæããã®ã§ã¯ãªããæ¢åã®Markdownææç©ãçŽæ¥ããŸãã¯ãšãŒãžã§ã³ããšäžç·ã«ä¿®æ£ããŠãã ãããgo ã®æ±ºå®ãåºãŠå®éã«éçºããå Žå㯠/speckit-specify ã«åŒãç¶ããŸããçç±ãæèšããäžã§åæ¢ããããšããæçšãªçµæã®äžã€ã§ãã
ã¢ã€ãã¢è©äŸ¡å®è·µã¬ã€ã · ã³ãã³ããªãã¡ã¬ã³ã¹
ããã»ã¹ãã«ã¹ã¿ãã€ãºããããŸãã¯èªåèªèº«ã®ããã»ã¹ãæã¡èŸŒã
æ¡åŒµæ©èœã¯æ°ããæ©èœã远å ããããªã»ããã¯æ¢åã®æåã調æŽããã¯ãŒã¯ãããŒã¯æé ãèªååãããã³ãã«ã¯ããŒã«ããŒã¹ã®ã»ããã¢ãããããã±ãŒãžåããŸããåçºã®ãã³ãã¬ãŒã倿Žã«ã¯ãããžã§ã¯ãããŒã«ã«ãªãªãŒããŒã©ã€ãã䜿çšããŠãã ããã
ã«ã¹ã¿ãã€ãºã¬ã€ã · ã³ãã¥ããã£ã®æ¡åŒµæ©èœã»ããªã»ããã»ãã³ãã«ã»ãŠã©ãŒã¯ã¹ã«ãŒ
ããã¥ã¡ã³ã
- CLIãªãã¡ã¬ã³ã¹ ãš ããã»ã¹ã³ãã³ã
- SDDã®ç念ãå®å šãªæ¹æ³è«ãæ¢åã®ä»æ§ã®é²å
- ãããžã§ã¯ãã®æŽå²
- Spec Kitã¯Spec Kitèªèº«ãã©ã䜿ã£ãŠããã
ã¹ã¿ãŒæ°ã®æšç§»
Spec KitãèŒãããŠãããããã¹ãŠã®çããã«æè¬ããŸãã
ãµããŒããšè²¢ç®
ãã°ãå ±åããããŸãã¯æ©èœããªã¯ãšã¹ããã · ã³ã³ããªãã¥ãŒã·ã§ã³ã¬ã€ã · è¡åèŠç¯
Spec Kitã¯MITã©ã€ã»ã³ã¹ã®äžã§æäŸãããŠããŸãã