dsh-spec-loop：DeepSeek Harness 的规格驱动开发闭环插件

dsh-spec-loop 是 DeepSeek Harness（DSH）的规格驱动开发闭环插件（DSH plugin），由 tianji-qingtian 维护，采用 MIT 协议，最近更新于 2026-08。它解决的是在 DSH 工作区内以 OpenSpec 兼容的目录结构（<workspace>/openspec/）管理规格、变更和验收的问题，将「生成规格 → 批准 → 实现 → 逐条验收 → 归档」的完整流程固化为一套 /spec 命令族。核心能力包括：/spec 命令族（init、new <goal>、status、list、show <id>、approve <id>、implement <id>、verify <id> [--deep]、archive <id>、validate [id]、edit <id>），内置与 OpenSpec CLI 一致的校验器，以及基于标准事件折叠的持久化状态机（proposed → approved → implemented → verified → archived）。

dsh-spec-loop 这个 DSH plugin 支持哪些核心特性？

该插件提供完整的规格驱动开发闭环。/spec new 会通过 harness 问题 UI 提出最多三个内置选择题（范围/约束/验收），语言跟随目标语言；verify 会针对每个 Requirement/Scenario 调用有界 judge（默认 flash，--deep 时用主模型），并执行 proposal.md 中声明的验证命令，最终写入带 ✅/❌ 表格的 verify.md。状态机由标准事件（command/run/command/done 对 + 机器可读标记）折叠而成，因此变更卡片、阶段和门禁在重启后依然有效，且不会向日志追加自定义事件类型。

dsh-spec-loop 怎么安装？

安装前需确保 dsh CLI 在 PATH 中（若仅通过 npx 使用 harness，需先全局安装 @deepseek-ai/dsh）。然后通过以下命令将插件添加到 web profile（推荐使用发布标签 #v0.1.2，#main 跟踪最新提交）：

dsh plugin --profile web add github:tianji-qingtian/dsh-spec-loop#v0.1.2

添加后重启对应 profile 的 harness 即可生效。

dsh-spec-loop 兼容哪些 DeepSeek Harness 版本和平台？

该插件面向 DeepSeek Harness 开发者预览版设计，官方提示迭代迅速，可能引入破坏性变更。它依赖 @deepseek-ai/dsh-commands、@deepseek-ai/dsh-fs、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-session 等官方包，并利用 agent.steer、conversation.input.dock、locale 服务等 harness 能力。插件本身以 JavaScript 编写，仓库内已提交构建产物 lib/，安装时无需执行构建脚本。

dsh-spec-loop 的变更目录和校验规则是怎样的？

变更目录遵循 OpenSpec 布局：openspec/project.md、openspec/specs/<capability>/spec.md、openspec/changes/<change-id>/{proposal.md,tasks.md,design.md,verify.md,specs/<cap>/spec.md}，归档到 changes/archive/YYYY-MM-DD-<id>/。规格增量使用 ## ADDED|MODIFIED|REMOVED Requirements 和 #### Scenario: 格式。内置校验器在提案生成后自动运行，失败时会引导 agent 进行有界重试；approve 拒绝未通过校验的变更，archive 拒绝缺失的变更。

dsh-spec-loop 的变更卡片和任务进度如何工作？

输入卡片上方（conversation.input.dock）会显示全宽变更卡片，包含当前 change-id、阶段、任务进度 x/y 和下一步命令。任务进度读取标准 todos 投影（实现提示将 tasks.md 镜像到 todo_write），零 RPC 开销。UI 字符串通过 harness 的 locale 服务本地化，支持中英文。

查看更多 DSH 插件，访问 dsh-plugin.org