前言¶

DeepSeek Harness（DSH）採用插件化架構，允許通過 Cordis 插件擴展功能。默認的 agent-loop 行爲通常缺乏結構化的工程約束。dsh-gsd-bundle 插件將 Git Ship Done（GSD）重新實現爲 host-plane 的 Cordis 插件集，將默認的 agent-loop 替換爲 GSD phase loop。這使得每一次會話都成爲受控的、基於產物的工程循環。

核心定位¶

該插件核心目標是重新實現 opengsd-core，並將其集成到 DSH 生態中。它提供了 checkpoint-resume、window ledger、conversational UAT loop、capability gates 以及 background-job runtime。數據統計顯示，該插件包含 28 個 Cordis 插件行（1 個 override + 27 個 inserts）、37 個 gsd_* 工具以及 34 個 /gsd-* 命令。

GSD Phase Loop¶

每個工作單元被定義爲一個 phase，必須按順序經過以下步驟：

Spec → Discuss → (UI design, optional) → Plan → Execute → Verify → Ship

該循環通過 advisory soft gates 進行約束，例如在 Plan 後進行 gap-analysis，在 Execute 後進行 code-review 和 ui-review，在 Ship 前進行 validate。系統狀態保存在磁盤的 .planning/ 目錄下，STATE.md 作爲導航錨點，確保狀態在會話間持久化且在上下文重置後可用。

主要功能¶

插件通過兩個主要里程碑版本完成了功能構建：

• v3.1（core-loop-helpers）

  • phase-management：直接在 ROADMAP.md 中管理階段。
  • smart-entry：檢測當前項目狀態並路由至最佳下一步。
  • freeform-routing：解析自然語言意圖並調度命令。
  • quick-batch：批量運行任務。
  • fast-mode：提供輕量級單次通過路徑。
  • mvp-phase：交互式範圍定義流程。
  • node-repair：針對驗證失敗的階段進行有界自動修復。
  • review-fix-companion：重構代碼審查修復功能。

• v3.0（upstream-parity）

  • spec-phase：生成 SPEC.md，並通過模糊度評分（≤ 0.20）進行門控。
  • gap-analysis：生成需求與計劃的覆蓋表。
  • code-review & ui-review：執行代碼和 UI 審查。
  • validate-phase：映射需求到測試基礎設施。
  • undo：通過 git revert 進行安全回滾。
  • health：診斷 .planning/ 目錄的完整性。
  • assumption-delta：在 plan:pre 鉤子中檢查架構假設變更。
  • pause-resume-work：支持階段暫停與恢復。
  • autonomous：驅動剩餘未完成階段。
  • add-tests：自動生成測試文件。

典型用法¶

以下是基於事實的命令使用場景：

1. 階段管理
   使用 /gsd-phase-manage 在 ROADMAP.md 中添加、插入、移除、重新排序或編輯階段，系統會自動保持 ROADMAP.md、進度表和 STATE.md 的一致性。

2. 狀態路由
   使用 /gsd-next 檢測當前項目狀態並自動路由至最佳下一步操作。

3. 意圖解析
   使用 /gsd-route 將自然語言意圖解析並調度到最合適的 GSD 命令（僅推薦，不自動運行）。

4. 快速模式
   對於簡單階段，使用 /gsd-fast-mode 啓動輕量級單次通過路徑。

5. MVP 定義
   使用 /gsd_mvp_phase 進行交互式範圍提議與確認，生成 PLAN.md。

6. 修復流程
   使用 /gsd_repair 對驗證失敗的階段進行有界自動修復（最多 2 輪），生成修復報告。

7. 代碼審查修復
   使用 /gsd_code_review --fix 重建審查修復功能，執行有界錨定編輯契約。

環境與依賴¶

• 運行環境：需要 Node.js 版本 >= 20。
• 許可證：MIT License。
• 狀態存儲：狀態保存在 .planning/ 目錄下，依賴 workflow.assumption_delta 進行架構檢查。
• 門控機制：spec-phase 階段受模糊度評分門控（4 個加權清晰度維度得分總和 ≤ 0.20）。

資源¶

• GitHub 倉庫
• 技能目錄頁