前言¶
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 中構建標準化研發流程的團隊。
