前言¶
手里有一份 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 安装文档。