前言¶
DeepSeek Harness（DSH）采用插件化架构，允许用户通过插件扩展工作流能力。dsh-e2e-dev-sdd 插件旨在为 DSH Web 提供一个五阶段 Specification-Driven Development（SDD）工作台。它将需求讨论、原型输出、系统设计、规格设计和开发测试拆分为五个独立入口。与传统的固定流水线不同，这五个阶段默认作为可选能力存在，用户可以根据当前需求选择需要的来源和已接受的交付件，与 DSH Agent 对话迭代并提交成果。
核心功能¶
项目看板与交付管理¶
项目看板将需求包、独立交付工作单元、独立缺陷与需求内缺陷分开汇总。它提供缺陷交付覆盖、外部工作量统计，以及五阶段状态分布、交付范围燃起图和可筛选的交付矩阵。需求内缺陷归入所属需求，不重复增加五阶段行或燃起范围。
五阶段工作流¶
提供需求讨论、原型、系统设计、规格设计、开发测试五个一级菜单，共用同一套项目和交付件协议。一个 DSH Workspace 对应一个可提交的 .sdd/ 项目空间，主需求下的每个可独立交付子项拥有自己的工作单元。
来源与同步机制¶
业务适配器统一返回 source-bundle@1。内置零配置手工来源，允许在没有企业适配器时直接填写标题和描述。再次同步同一主 ID 时，会预览新增、修改、移除和无变化项，确认后才应用。导入前可逐条查看完整正文、元数据、业务关系和当前已导入版本。
交付件与模板¶
初始化时会生成 .sdd/templates/<stage>/template.yaml 与 deliverable.md。交付件是可包含正文、图表、原型和附件的多文件包。人工接受交付件并冻结内容 SHA-256。已接受交付件不可被静默覆盖，需求变化会保存新的来源快照，不覆盖历史。
仓库集成与规划¶
代码仓库可在项目设置统一登记。已关联仓库会自动作为需求、原型、系统设计和规格设计会话的只读辅助输入。内部规划引擎贯穿五阶段，但用户无需感知底层 OpenSpec。开发测试阶段会从选定基线创建 sdd/... 特性分支，并为每个需求的代码开发创建独立 Worktree 或 Clone，不污染主项目空间。
扩展与适配¶
支持可注册的需求/缺陷 Source Provider（包括 Cordis 服务和内置无 shell 的命令型 Provider）。企业通用 Connector 与适配器放在插件 business/，项目专用适配放在 .sdd/business/。每个阶段拥有独立的 System Prompt、输入门禁、工具执行 Guard、结构质量检查和验收清单。
安装¶
安装插件到 Web profile：
dsh plugin --profile web add dsh-e2e-dev-sdd@latest
安装后重启 dsh web，侧边栏会出现五个阶段入口。
典型用法¶
- 初始化项目：在 DSH 中打开一个 Git 仓库作为 Workspace。进入任一阶段菜单，检查
.sdd/project.yaml。未初始化时点击“初始化项目”。 - 配置仓库：在“项目设置”中配置外层 SDD 项目仓库的 remote、协作基线、同步策略和提交范围。
- 同步来源：在项目看板点击“获取并预览需求包”或“获取并预览独立缺陷”。确认清单内容后应用。
- 选择输入：从页面顶部选择当前需求工作单元，点击“选择/调整输入”选择当前来源和上游阶段最新 accepted 交付件。
- 开始阶段：选择草稿并开始阶段对话。插件在对应 Session 安装阶段 System Prompt。
- 迭代与交付：与 Agent 迭代，Agent 必须按照页面所示模板输出，并把确定结论逐轮写入交付件。查看交付包和结构质量，确认阶段验收清单并接受版本。
- 开发测试：在开发测试阶段，只为已确认目标仓库创建隔离代码空间。通过“让 AI 验证”运行相关测试。
- 归档：点击“归档并沉淀到产品”，生成 FEAT 特性版本与当前产品规格。
适用场景与注意¶
- 灵活模式：默认允许跳过和自由组合输入，不自动串行运行全部阶段。只有在启用严格模式时，才会执行项目声明的 required 依赖。
- 数据源：Git 仓库文件是项目真源，浏览器状态不是。
- 版本管理：内部身份使用 UUID；交付件编号由插件按阶段固定生成；企业外部编号原样保留并显式关联。
- 历史保护：历史交付保持不可变，产品当前规格只表达当前有效事实。
.sdd/承担研发过程数据，product/和deliveries/是项目根目录下可直接阅读、提交和移交的固有资产。 - 外部材料：外部材料必须先转换为 Source Envelope，再由 AI 整合为正式交付件。
总结¶
dsh-e2e-dev-sdd 插件通过解耦需求、设计、开发和测试流程，提供了更灵活的规格驱动开发方式。它通过模板、多文件交付和严格的变更检查机制，确保了交付件的质量和可追溯性，适合需要在 DeepSeek Harness 中构建标准化研发流程的团队。
