prd-sdd-studio skill・使用前先看

等一下會發生什麼、會問你什麼、該怎麼選

這個 skill 把一個構想一路帶到可運行的程式碼:諮詢對話 → PRD → SDD → 架構圖 → TASK.md → 一步步開發,而且每次改動都留痕、問你要不要 commit、再把文件同步到最新。大腦是 Claude 本身,不叫任何外部 API。

自動啟動偵測掃資料夾,有進度就接力

你選主選單五個功能

對話PRD 諮詢MVP 或完整

你選SDD 架構師四種模式

你確認規劃 TASK.md按層拆 4–8 個

迴圈一步步開發留痕・git・文件同步

先回答三題,我把你的路線標出來

選完之後,下面「完整流程」裡不相干的步驟會變淡,你會走到的選項會先幫你選好,並列出它會停下來問你的問題順序。

1・你現在的資料夾裡有什麼?

2・這個專案的性質?

3・技術棧你想怎麼決定?

你的路線

它會停下來問你的問題(依序)

橘色框是它會停下來問你的地方,點選項可以看接下來會去哪一步。綠色虛線框是產出檔案。

它不是按一個鍵就全自動。停下來問,才是你敢讓它動你專案的原因。

🔍啟動時:偵測到什麼有進度就問「要接力嗎」,有文件就先摘要它的理解請你確認,要放棄舊專案會建議另開乾淨資料夾。

💬PRD 諮詢:每輪 1–2 題至少 2 輪才給你 [g] 生成。你貼的圖、參考資料都會用。

🏗SDD:選模式(＋精簡版加問一題)完整版不問;精簡版問 Streamlit 還是 FastAPI/Flask;特定技術與互動式會來回對話。

⚡開發前:MVP 快速首次上線?只在 PRD 是 MVP 模式且第一次規劃 TASK.md 時問。選是就整輪連續做完、最後一次收尾。

📋TASK.md 給你看過才開工可調順序、合併、刪減。每個任務做完問你要不要繼續下一個。

🔐每次改動後:git?文件同步?先寫 CHANGELOG,再問要不要 commit;commit 後才問要不要把 PRD/SDD 同步,而且先給 diff 等你確認。

全部長在你叫出 skill 時 Claude Desktop 選定的專案資料夾底下(新專案會問你一個英文 kebab-case 名稱開子資料夾),不會寫到別處。

📄PRD.md需求文件。MVP 版 2000–4000 字;完整版 4000–8000 字、IEEE 830、MoSCoW 優先級。不含技術棧,技術留給 SDD。

📐SDD.md設計文件,讀者是 AI Coding Agent。結尾一定有 §10 實作路徑,那是拆任務的依據。預設不含 Docker / K8s / CI-CD。

🗺docs/diagrams/*.puml + .png概念架構圖(PRD 階段,給 PM 看)和技術架構圖(從 SDD 反推,圖文一致)。.puml 一定寫出來;PNG 只對外送一次,失敗退 SVG,再失敗離線保留,不卡流程。

✅TASK.md按層拆的任務清單,ID 是 TASK-001…,狀態 ⬜🔵✅⏸,進度總覽在最上面。下次回來它靠這個接力。

📝CHANGELOG.md每次改動一筆:做了什麼、為什麼、影響檔案、Git 狀態、文件同步狀態。最新在上,時間戳用真實時間。

💻你的程式碼依 SDD 的檔案結構寫出來,commit 訊息帶 [TASK-NNN]。

先偵測、後問、不重來。每次啟動先掃資料夾;有半成品就接力,有現成文件就讀懂後確認,絕不擅自重生成。

絕不 push、絕不 --force。預設只做本地 commit;commit 前 git status 給你看;分支尊重你的習慣,可以直接在 main。

碰到 .env / *.key / *secret* 會停下來。提醒你確認是否該被 .gitignore 忽略,不會把秘密 commit 進去。

文件同步是半自動。先提「原文 → 改後」diff 等你確認才寫回;文件同步後的 commit 不再觸發下一輪同步,避免迴圈。

日期一定查真。文件日期、CHANGELOG 時間戳都用工具取當下時間,不沿用模板或編造。

同一任務失敗 ≥2 次就停。TASK.md 標 ⏸ 阻塞、CHANGELOG 記 root cause,回頭找你,不硬撐。

放棄舊專案不刪檔。強烈建議另建乾淨新資料夾;堅持原地重來要二次確認。

全程繁體中文、CLI 編號選單。每個選擇都是「輸入數字」,不用記指令。