前言¶
手裏有一份 PRD,希望 AI 不只「直接改代碼」,而是先弄清需求、對照倉庫、出可覈對的技術方案,再拆任務、實現、驗證——這類流程若全靠口頭約束,Agent 容易跳過探索、方案與人工確認。下面介紹 SkillHub 上的社區 Skill「SDD 驅動開發工作流」:用需求文檔(PRD)與可選的 SDD 知識庫,把上述過程固化爲六階段工作流,並強調證據驅動與方案先行。
這是什麼¶
SDD 驅動開發工作流(座標 @user_db7ebc1c/sdd-driven-dev,版本 1.0.0)是 SkillHub 社區發佈者 user_db7ebc1c 維護的 dev-programming 類 Skill,基於通用 SKILL.md 格式。標籤 requires_api_key=false,不依賴額外 API Key。
它解決的是:在「基於需求文檔讓 AI 做開發」的場景裏,統一從 PRD 獲取到驗證的推進順序,並把分析結論綁定到代碼或 SDD 位置,在關鍵決策點留出人工校驗。
官方頁面:SkillHub - SDD 驅動開發工作流
API 入口:https://api.skillhub.cn/user_db7ebc1c/sdd-driven-dev
核心功能¶
六階段工作流¶
按官方說明,流程依次爲:
- PRD 獲取
- 需求分析與代碼探索(可循環,產出改動點清單)
- 技術方案生成(與改動點逐項對應)
- 人工校驗與方案迭代
- 執行開發(可循環)
- 開發結果驗證(按需)
原則包括:證據驅動(結論需對應代碼或 SDD 位置)、方案先行、人工校驗關鍵決策。SDD 知識庫爲可選;未配置時仍可按 PRD 走同一套階段。
何時應觸發本 Skill¶
除六階段本身外,官方列出以下典型意圖與說法(節選):
- 分析需求、出技術方案、拆任務、寫代碼、做開發結果驗證
- 「執行 AI 開發需求工作流程」「基於 SDD 開發需求」「需求開發工作流程」
- 即未明說「SDD」,只要是「基於需求文檔讓 AI 做開發」,也優先使用本 Skill
四個內置可選工具¶
- 反饋留檔(觸發示例:「提交 AI 開發 workflow 反饋」)
- SDD 缺口清單整理(「把缺口清單整理」)
- 測試 Bug 分析總結(「分析測試提的 bug」)
- AI 自動 CR(硬性規則掃描;「執行 AI 自動 CR」)
安裝與啓用¶
安裝說明以 SkillHub 通用文檔爲準:https://skillhub.cn/install/skillhub.md。官方頁面對本 Skill 的提示爲:按該文檔安裝 @user_db7ebc1c/sdd-driven-dev。
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄,否則默認落在 ./skills/ 可能無法被 Agent 加載。
skillhub install @user_db7ebc1c/sdd-driven-dev --dir <skills 目錄>
常用路徑(來自 SkillHub 安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
也可將安裝說明發給 AI,讓其按 https://skillhub.cn/install/skillhub.md 完成安裝。具體是否需重啓或刷新會話,以你所用客戶端對 Skills 的加載規則爲準;官方安裝文檔未單獨爲本 Skill 寫明差異。
典型用法¶
以下均爲官方資料中可復現的觸發方式,不涉及虛構案例。
從 PRD 走完整開發流程:提供 PRD 或需求文檔路徑/內容,並說明需要分析、方案、開發與驗證,或使用「執行 AI 開發需求工作流程」「需求開發工作流程」等表述。
帶 SDD 知識庫:在同樣意圖下說明已有 SDD 或知識庫位置,使用「基於 SDD 開發需求」;缺口可在流程中用「把缺口清單整理」交給內置工具處理。
流程中的輔助動作:
- 對本次 workflow 留檔:「提交 AI 開發 workflow 反饋」
- 測試問題歸納:「分析測試提的 bug」
- 提交前規則掃描:「執行 AI 自動 CR」
經過上面的步驟,Agent 應按 Skill 內規則在「探索—方案—人工確認—開發—驗證」之間推進,而不是跳過方案直接改代碼。
適用場景與注意¶
適合誰:已有 PRD 或等價需求說明,希望在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏,用統一階段約束 AI 做需求開發;有 SDD 時可疊加知識庫,沒有也可僅用 PRD。
限制與注意:
- 第四階段「人工校驗與方案迭代」是設計上的卡點,不宜省略;Skill 強調關鍵決策需人確認。
- 結論應能追溯到代碼或 SDD 位置;若倉庫與 PRD 不一致,需靠探索與缺口清單補齊,不能憑猜測寫方案。
- SkillHub 頁面顯示本 Skill 評分 100000、下載 983(數據隨平臺更新);與線索中的統計可能不一致時,以 SkillHub 頁面爲準。
- 社區來源(
community),使用前可在 SkillHub 查看版本與說明是否與本地安裝一致。
結尾¶
SDD 驅動開發工作流把「PRD + 可選 SDD」驅動的需求開發收成六階段,並附帶反饋、缺口、Bug 分析與自動 CR 等可選工具,適合需要方案先行與證據鏈的團隊習慣。安裝與座標:@user_db7ebc1c/sdd-driven-dev,說明與安裝指引見 SkillHub 技能頁 與 skillhub.md 安裝文檔。