dsh-openspec

dsh-openspec

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

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

• 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 工具）呈现，开箱即用。
• 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）。