前言¶
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：重构代码审查修复功能。
- phase-management：直接在
-
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：自动生成测试文件。
- spec-phase：生成
典型用法¶
以下是基于事实的命令使用场景：
-
阶段管理
使用/gsd-phase-manage在ROADMAP.md中添加、插入、移除、重新排序或编辑阶段，系统会自动保持ROADMAP.md、进度表和STATE.md的一致性。 -
状态路由
使用/gsd-next检测当前项目状态并自动路由至最佳下一步操作。 -
意图解析
使用/gsd-route将自然语言意图解析并调度到最合适的 GSD 命令（仅推荐，不自动运行）。 -
快速模式
对于简单阶段，使用/gsd-fast-mode启动轻量级单次通过路径。 -
MVP 定义
使用/gsd_mvp_phase进行交互式范围提议与确认，生成PLAN.md。 -
修复流程
使用/gsd_repair对验证失败的阶段进行有界自动修复（最多 2 轮），生成修复报告。 -
代码审查修复
使用/gsd_code_review --fix重建审查修复功能，执行有界锚定编辑契约。
环境与依赖¶
- 运行环境：需要 Node.js 版本 >= 20。
- 许可证：MIT License。
- 状态存储：状态保存在
.planning/目录下，依赖workflow.assumption_delta进行架构检查。 - 门控机制：spec-phase 阶段受模糊度评分门控（4 个加权清晰度维度得分总和 ≤ 0.20）。
