前言¶

在 DeepSeek Harness（DSH）插件体系里，智能体开发常需要把“怎么做”从提示词建议变成可调用、可校验的技能。@wenaixi/dsh-superpower 面向这个需求，将 obra/superpowers 的 DSH 完整移植为 DSH 插件，把 14 个技能注入 ctx.skills，开箱即用，全中文。

这是什么¶

Wenaixi/dsh-superpower 是 obra/superpowers 的 DSH 完整移植，npm 包名为 @wenaixi/dsh-superpower。它提供的不是单点提示词，而是一套强制性方法论：先设计 → 计划切片 → TDD → 系统化调试 → 评审集成。

插件以 dsh.bundle 形式管理，随安装/卸载生效，不污染用户目录，并支持 HMR 自动重建。许可证为 MIT，与上游 obra/superpowers 保持一致。

核心能力¶

• 14 个技能注入 ctx.skills，开箱即用，全中文。
• 提供强制性方法论：先设计 → 计划切片 → TDD → 系统化调试 → 评审集成。
• 安装方式支持 npm、GitHub 直装、本地路径、离线 tarball 安装。
• 随 dsh.bundle 安装/卸载，不污染用户目录，HMR 自动重建。
• 自 v6.3.1 起，本仓库脱离上游独立演进，上游基准锁定 obra/superpowers v6.3.0。

安装与启用¶

前置要求：

Node >=20
pnpm >=9
dsh

先安装 dsh：

npm i -g @deepseek-ai/dsh

然后以 web profile 为例添加插件：

dsh plugin --profile web add @wenaixi/dsh-superpower

其他 profile 将 --profile web 改为对应 profile 名即可。若 npm 侧出现 404 或镜像延迟，可改用 GitHub 形式安装；如需锁定版本，可在包名后追加 @<version> 或 #v<version>。

注意：旧名 dsh-superpower（无 scope）已废弃并 npm deprecate，请改用 @wenaixi/dsh-superpower。

校验¶

安装后，可以通过技能列表校验：

await ctx.skills.list({cwd})

预期结果中应有 14 条 provider: superpowers。

典型用法¶

下面是可复现的技能链路示例：

• “帮我做 XXX” → superpower-brainstorming → superpower-writing-plans → superpower-subagent-driven-development
• “修这个缺陷” → superpower-systematic-debugging
• “帮我评审” → superpower-requesting-code-review

依赖与配置¶

package.json 中的关键约束如下：

{
  "name": "@wenaixi/dsh-superpower",
  "version": "6.3.1",
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-skill": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
    "@deepseek-ai/schemastery": "^3.18.1"
  },
  "dsh": {
    "bundle": {
      "patch": "./cordis.patch.yml"
    }
  }
}

也就是说，插件对 @deepseek-ai/cordis、@deepseek-ai/dsh-skill、@deepseek-ai/schemastery 有 peer 依赖要求，并通过 dsh.bundle.patch 指向 ./cordis.patch.yml。

适用场景与注意¶

适合在以下场景使用：

• 希望把开发方法论接入 DSH 的 ctx.skills，而不是只依赖自由文本提示。
• 需要在 DSH 会话中调用设计、计划、TDD、调试和评审等技能。
• 偏好中文技能说明，并希望插件随 dsh.bundle 管理安装与卸载。

使用前注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。
• 若环境中的 DSH 相关 peer 依赖版本不满足，需要先调整依赖版本。
• 旧包名 dsh-superpower 已废弃，应使用 @wenaixi/dsh-superpower。

结尾¶

@wenaixi/dsh-superpower 的价值在于把 obra/superpowers 的方法论落进 DSH 插件链路：技能可枚举、可校验，安装卸载随 dsh.bundle 管理。

插件目录可按 @wenaixi/dsh-superpower 查找；GitHub 仓库：https://github.com/Wenaixi/dsh-superpower