superpowers-dsh：给 DeepSeek Harness 装上 TDD、调试与规划技能

DeepSeek Harness 插件 DeepSeek DSH 技能 TDD superpowers-dsh 2026-08-17 151 阅读

前言

DeepSeek Harness（下文简称 DSH）把模型、工具、技能、会话、沙箱和界面都做成可装卸的插件。官方仓库的定位就是「Everything is a Plugin」：能力不写死在内核里，而是挂到 Cordis 的共享上下文上，按 profile 组合。技能（skills）也属于这一层——它们不是新工具，而是一段段可被 skill 工具加载的工作纪律。

编码智能体接到「加个功能」「修个 bug」时，常见做法是直接改代码。设计没对齐、测试没先红、根因没查清，下一轮又在症状上打补丁。Jesse Vincent 维护的 obra/superpowers 把这套流程拆成可组合技能：先头脑风暴，再写计划，实施走 RED-GREEN-REFACTOR，调试先查根因。上游仓库以 MIT 协议开源，官方 README 给出了 Claude Code、Cursor、Codex、Gemini CLI 等多套安装方式，但列表里没有 DeepSeek Harness。

superpowers-dsh 做的就是这件事：把 Superpowers 的核心技能移植到 DSH 的 Cordis 插件架构上，随包分发 SKILL.md，安装后注册进 host 层技能表。本文根据插件目录页、GitHub 仓库 README、package.json、lib/index.js 以及上游 Superpowers 资料交叉核对后写成，写作日期为 2026-08-17。

这是什么

superpowers-dsh 是一款 技能类 DSH 插件，由 LayneChai 维护，仓库地址是 LayneChai/superpowers-dsh。社区插件目录把它归在「技能」分类，收录日期为 2026-08-15。它不是 DeepSeek / 幻方的官方组件；deepseek-harness-plugin.com 是独立的社区目录，与 DeepSeek 官方无从属关系。官方发现渠道仍是 GitHub 的 dsh-plugin topic。

一句话定位：安装后，当前 profile 里的每个 agent 会话都能在技能目录里看到 14 个 Superpowers 技能，并用 DSH 自带的 skill 工具按需加载。技能正文在包内的 skills/<name>/SKILL.md，通过 import.meta.url 定位，不需要用户再配路径。

仓库创建于 2026-08-14，主要语言是 JavaScript。本文写作时 GitHub 显示 44 星；目录页当时仍显示 27 星，以仓库页面为准。npm 包名同样是 superpowers-dsh，页面上的最新版本是 0.1.1（2026-08-14 发布）；GitHub main 分支的 package.json 仍写 0.1.0。从 GitHub 规格安装会跟随仓库当前提交，从 npm 安装会拿到已发布版本，两者不必视为同一份产物。

核心功能

插件向 ctx.skills 注册表的 host 层 注册一个技能提供者。host 层的行会进入每个 agent preset 的作用域链，所以不必给每个 agent 单独再装一遍。lib/index.js 的实现很薄：只使用 Node 内置的 fs / path / url，消费注入的 ctx.skills 服务。list() 扫描包内 skills/ 目录，从 YAML frontmatter 解析 name、description、whenToUse；get() 按需读正文，并把 resourceBase 指到技能目录，相对引用（脚本、提示模板）才能解析。

cordis.patch.yml 在 dsh-base 层之上插入一行：

- insert:
  - id: superpowers-dsh
    name: 'superpowers-dsh'

后面的 profile 层和 --patch 叠加仍可按 id 找到这一行。

README 列出的 14 个技能可以按用途分成几组。下面的说明来自仓库技能表和已打开的 SKILL.md，不是使用体验评价。

入口

  • using-superpowers：怎么查找和调用技能。正文要求：只要有一点可能适用，就先用 skill 工具加载，再说话或动手。DSH 上技能用裸名称寻址，例如 brainstorming，不再带 superpowers: 前缀。

规划与协作

  • brainstorming：用协作对话把想法收敛成设计。
  • writing-plans：根据规格写实施计划。
  • executing-plans：按书面计划执行，并留下评审检查点。

实施与验证

  • test-driven-development：RED-GREEN-REFACTOR。仓库里的技能正文把「没有先看到失败测试，就不写生产代码」写成硬规则；原型、生成代码、配置文件需要先问使用者。
  • systematic-debugging：四阶段调试——根因调查、模式对比、单假设验证、再动手修。技能正文写明：没完成第一阶段，不能提修复方案。
  • verification-before-completion：声称完成之前先拿出证据。

多代理

  • subagent-driven-development：每个任务派发新的子代理并评审。
  • dispatching-parallel-agents：把可独立的工作扇出到并行代理。移植说明里，子代理引用映射到 DSH 的 subagent / subagent_fork；大规模扇出还可以用 DSH 自己的 workflow 工具。

评审与收尾

  • requesting-code-review / receiving-code-review：合并前做严格评审，收到意见先核实再改，而不是照单全收。
  • finishing-a-development-branch：安全整合已完成的工作。
  • using-git-worktrees：功能开发用隔离工作区。

扩展

  • writing-skills：以 TDD 方式编写并验证新技能。往包里再放一个带 YAML frontmatter 的 skills/<name>/SKILL.md 即可被 list() 发现，不必改插件代码。

相对上游，移植做了几处平台适配，都写在 README 的「移植说明」里：

  1. 去掉命名空间前缀，适配 DSH 的裸名称寻址。
  2. using-superpowers 指向 skills/using-superpowers/references/dsh-tools.md，给出 Claude Code 工具到 DSH 的对照（pwsh / bash、subagent、workflow、goal 等）。DSH 没有 hook 系统，工作流约束写在技能正文里。
  3. brainstorming 的视觉伴侣：Node 服务 scripts/server.cjs 全平台可跑；.sh 辅助脚本只在 bash 下可用。

安装与启用

目录页给出的安装命令如下，在 DeepSeek Harness 终端中运行即可：

dsh plugin add github:LayneChai/superpowers-dsh

插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。需要可复现安装时，把规格钉在具体 commit 上。本文核对 main 时，最新提交是 49e2d65db55b4d3ec065ad824efe9b09465c8a26（2026-08-14）：

dsh plugin add github:LayneChai/superpowers-dsh#49e2d65db55b4d3ec065ad824efe9b09465c8a26

commit 会继续前进，安装前以仓库页面为准。

仓库 README 补充了若干等价写法，面向已经在用 --profile 的用户。dsh plugin 内部会调用 pnpm，需要先能执行 pnpm --version。dsh 命令随 Harness 提供，常见启动方式是 npx @deepseek-ai/dsh web，所以它只在该进程环境里可用。可以先全局安装，也可以全程加 npx：

# 全局安装（README 推荐）
npm install -g @deepseek-ai/dsh
dsh --version

# 不装全局，所有命令用 npx
npx @deepseek-ai/dsh --version

README 写的「最简单一条命令」（不要求先全局安装 dsh）：

npx @deepseek-ai/dsh plugin --profile web add github:LayneChai/superpowers-dsh

从 npm 安装（包名 superpowers-dsh）：

dsh plugin --profile web add superpowers-dsh

注意：必须走 dsh plugin。直接 npm install superpowers-dsh 只会把包当普通库装到当前目录，不会写入任何 DeepSeek Harness profile，技能不会被加载。

也可以用完整 Git URL、tarball 或本地文件夹：

dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.git

bundle 层在 profile 启动时挂载。装完后需要停掉再重新运行 dsh web（或 npx @deepseek-ai/dsh web），然后刷新浏览器。确认层已经组合进去：

dsh --profile web --dump-config

输出里应当出现 superpowers-dsh 这一行。headless / tui / 自定义 profile 把 --profile 换成实际在用的名字即可。卸载同样要指定 profile，卸完也要重启：

dsh plugin --profile web remove superpowers-dsh

README 还提到一种方式：在 Web 界面新建对话，把仓库链接发给智能体，让它代跑 dsh plugin --profile web add。这依赖当前环境里的智能体是否会执行安装命令，不能代替你自己检查源码。

典型用法

安装并重启 profile 之后，这 14 个技能会出现在 agent 的技能目录里。入口技能是 using-superpowers。DSH 用 skill 工具按名称加载技能正文，仓库参考文档里的调用形式是：

skill(name: "brainstorming")

其他技能同样用裸名称，例如 writing-plans、systematic-debugging、test-driven-development。using-superpowers 写明：使用者写在 AGENTS.md 或会话系统提示里的指令优先于技能；技能再覆盖默认行为。只有在人明确要求跳过时，才可以不走技能流程。DSH 没有 Claude Code 那种 CLAUDE.md 自动装载，持久项目说明应放在 AGENTS.md。

上游 Superpowers README 给出的基本工作流，移植后仍然按这个顺序理解（技能名已去掉前缀）：

  1. 要做新功能时，先加载 brainstorming，把目标和约束问清楚，再进入设计。
  2. 设计认可后，用 writing-plans 拆成带路径、验证步骤的实施计划。
  3. 实施阶段加载 test-driven-development：先写失败测试并确认它因为缺功能而失败，再写最少代码让它通过，最后重构。
  4. 遇到失败或异常行为，先加载 systematic-debugging，完成根因调查再改代码。
  5. 任务之间可用 requesting-code-review；全部完成后走 finishing-a-development-branch。

这些步骤来自上游 README 与本插件技能列表的对应关系，不是某次真实会话的实录。插件本身不新增模型可调用的业务工具，它只把技能正文送进上下文；具体是否遵守，取决于当前模型和会话指令。

适用场景与注意事项

比较适合已经在跑 DeepSeek Harness、希望智能体按软件工程节奏做事的人：新功能从设计到计划、修 bug 时先查根因、需要子代理分任务或并行、以及想在 DSH 里沿用 Superpowers 那套技能名的人。如果你主要用 Claude Code / Cursor，应直接安装上游 obra/superpowers，不必绕道这个移植包。

使用前有几件事需要说清楚：

  1. 权限与信任。插件以当前 dsh 进程的权限运行，安装时可能执行构建脚本。社区目录和 GitHub 都提醒：只安装你审查过的源码。固定 commit 哈希可以得到可复现的安装。
  2. 许可证。README、package.json 和 npm 页面均标注 MIT，并写明技能内容改编自 obra/superpowers（MIT，© Jesse Vincent 及贡献者）。仓库当前 没有 独立的 LICENSE 文件，GitHub API 因此未识别许可证字段。安装前请自行打开 README 与上游许可证核对。
  3. 生态归属。这是社区维护的适配包，不是 DeepSeek Harness 官方插件商店里的「认证应用」。目录站点是第三方收录。
  4. 安装方式。dsh plugin 依赖 pnpm；装完必须重启 profile。不要用裸 npm install 代替。国内用户如需加速 npm 源，README 提到可把 registry 设为 https://registry.npmmirror.com，这是作者说明，不是必须步骤。
  5. 平台限制。brainstorming 附带的 .sh 脚本只在 bash 下可用；Windows 上应使用 pwsh 或仓库提供的 Node 脚本。dsh-tools.md 还写明：只读沙箱里的 pwsh 运行在 ConstrainedLanguage，需要 .NET API 时可能要提升 sandbox_permissions。
  6. 能力边界。插件提供的是方法论文本，不会替你跑测试、也不会保证模型每次都先写失败用例。技能正文语气很硬，但仍可被用户指令覆盖。

小结

superpowers-dsh 把 obra/superpowers 里面向编码智能体的 TDD、系统化调试、规划与协作技能，接到了 DeepSeek Harness 的 host 技能注册表上。安装命令以目录页为准：

dsh plugin add github:LayneChai/superpowers-dsh

装完重启 profile，用 dsh --profile web --dump-config 确认出现插件行，再用 skill 工具按裸名称加载。源码和许可证请在安装前自己看一遍。

  • 目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/superpowers-dsh/
  • GitHub：https://github.com/LayneChai/superpowers-dsh
  • 上游技能库：https://github.com/obra/superpowers
  • DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness

相关文章

快速从零部署一个DeepSeek-R1服务 2025-04-05 使用 dsh-anchored-standard 为 DeepSeek Harness 配置两阶段 Agent 预设 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 网页界面补成工作台 2026-08-17 用 modlens 给 DeepSeek Harness 的纯文本模型补上视觉 2026-08-17 用 dsh-TUI 给 DeepSeek Harness 补上全屏终端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜