dsh-openspec

OpenSpec（规格驱动开发）for DeepSeek Harness（dsh）。

一个 Cordis 插件，通过两条互补通道把 OpenSpec 的能力注入 dsh agent：

1. Skills —— 在 ctx.skills 上注册 12 个捆绑的 OpenSpec SDD 工作流技能 （openspec-propose、openspec-explore、openspec-apply-change、 openspec-verify-change、openspec-archive-change 等），与上游 skills/ 目录逐字同步。模型端由 dsh 自带的 skill 目录机制（<system-reminder>
   • skill 工具）呈现，开箱即用。
2. Tools —— 在 ctx.tools 上注册 6 个原生工具，封装 openspec CLI 并返回 结构化结果（stdout/stderr/退出码 + 解析后的 JSON）： openspec_context、openspec_run、openspec_status、openspec_list、 openspec_validate、openspec_init。

安装

# 需要 pnpm；profile 可以是 web / headless / 自定义
dsh plugin --profile web add /path/to/dsh-openspec
# 然后重启 GUI / 运行 headless 会话

插件声明了 dsh.bundle.patch，dsh plugin 会自动把它加入 profile 的 bundle 层； 也可以在 profile 的 cordis.patch.yml 手动挂载：

- insert:
    - id: openspec
      name: dsh-openspec
      config: {}

配置

| 字段 | 默认 | 含义 | |---|---|---| | cliPath | openspec | CLI 可执行文件（经 PATH 解析） | | skillsDir | 包内 skills/ | 技能目录覆盖 | | skillsEnabled | true | 是否注册技能 provider | | toolsEnabled | true | 是否注册原生工具 | | skillRank | 600 | 捆绑技能 rank（项目/用户技能优先） | | timeoutMs | 60000 | 每次 CLI 调用预算 | | initTools | agents | openspec_init 默认 --tools |

开发

npm test          # node:test 单元测试（13 例，无需 dsh 运行时）

端到端验证：把插件装入一个 headless profile（见仓库根 README），运行 dsh --profile headless "…" 会话确认技能目录与工具可见、openspec_context 可用。

捆绑技能同步

skills/ 是上游 Fission-AI/OpenSpec 仓库 skills/ 目录的逐字拷贝（去掉了 README.md）。上游技能更新时，从 https://github.com/Fission-AI/OpenSpec/tree/main/skills 重新拷贝即可。

License

MIT。捆绑的 OpenSpec 技能版权归 OpenSpec 项目（MIT）。