superpowers-dsh

<div align="center">

[English](README.en.md) | 简体中文

</div>

<div align="center">

</div>

superpowers-dsh

为 DeepSeek Harness (DSH) 打造的 Superpowers 插件包：把

obra/superpowers 的核心技能

（Claude-Code 技能库：TDD、调试、规划、协作模式）移植到 DSH 的 Cordis

插件架构上。

插件会向 ctx.skills 注册表的 host 层 注册一个技能提供者，因此每个

agent preset 的作用域链都会合并这些技能。技能正文随包分发

（skills/<name>/SKILL.md），通过 import.meta.url 定位——这是包的

组装事实，不需要任何用户配置。

目录

• [在 DeepSeek Harness 中安装与使用](#在-deepseek-harness-中安装与使用)
• [DSH 版本兼容性](#dsh-版本兼容性)
• [技能列表](#技能列表)
• [工作原理](#工作原理)
• [上游同步](#上游同步)
• [移植说明](#移植说明)
• [添加自己的技能](#添加自己的技能)
• [许可证](#许可证)

在 DeepSeek Harness 中安装与使用

这是 DeepSeek Harness 的插件包。安装后会把下面的 15 个技能注册进

host 技能注册表，你 profile 里的每个 agent 会话都能在技能目录中看到它们，

并可用 skill 工具加载。技能内容同步自上游 obra/superpowers v7.0.1。

最简单：一条命令

不需要先全局安装 dsh，在任意目录执行：

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

装完后重启 npx @deepseek-ai/dsh web（或 dsh web），刷新浏览器即可。

最推荐：直接让 DeepSeek Harness 帮你安装

打开 DeepSeek Harness（Web 界面），新建对话，把下面这句话发给它：

帮我安装这个链接里边的插件：https://github.com/LayneChai/superpowers-dsh

Agent 会自动完成安装（dsh plugin --profile web add → 重启 profile →

验证技能注册），无需你手动敲任何命令。装完后你可以在对话里让它运行

dsh --profile web --dump-config，确认输出里有 superpowers-dsh 行。

从 npm 安装（推荐，一条命令）

包已发布到 npm，名为 superpowers-dsh（国内会自动同步到 npmmirror 镜像）：

dsh plugin --profile web add superpowers-dsh

必须用 dsh plugin 形式——直接 npm install superpowers-dsh 只会把包当

普通库装到当前目录，不会注册进任何 DeepSeek Harness profile，技能

永远不会被加载。

从 GitHub 安装

# 任意目录下执行
dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.git

从 tarball 或本地文件夹安装

# tarball（例如 Release 里的 superpowers-dsh-0.1.0.tgz）
dsh plugin --profile web add C:\路径\to\superpowers-dsh-0.1.0.tgz

# 或解压后的插件文件夹（pnpm 以链接方式安装，改完重启即生效）
dsh plugin --profile web add C:\路径\to\superpowers-dsh

重启并验证

bundle 层在 profile 启动时挂载，所以需要重启 profile（停掉后重新运行

dsh web / npx @deepseek-ai/dsh web，再刷新浏览器）。确认层已组合：

dsh --profile web --dump-config     # 必须出现 `superpowers-dsh` 行

之后技能会出现在 agent 技能目录中（using-superpowers 是入口技能），

可以用 skill 工具加载。

安装成功后的界面如下：

在其他 profile（headless / tui / 自定义）中使用

把 --profile 指向你实际运行的 profile：

dsh plugin --profile headless add superpowers-dsh
dsh --profile headless --dump-config

卸载

dsh plugin --profile web remove superpowers-dsh
# 卸载后同样需要重启 profile

注意事项

• 国内用户可以先把 npm 镜像设为 npmmirror，让 `dsh plugin add

superpowers-dsh 更快：npm config set registry https://registry.npmmirror.com`

• 从文件夹或 file: 规格安装的插件是链接安装（不是复制）：修改该文件夹后，

下次重启 profile 生效

• 使用者不需要 npm 账号，也不需要 2FA——安装只是普通的包下载

DSH 版本兼容性

结论：与 npm 上已发布的全部 DSH 版本兼容；已在 DSH 0.2.0-rc.2（当前 latest）上端到端实跑验证。无已知不兼容问题。

核对日期 2026-10-03，npm 发布通道：latest = next = 0.2.0-rc.2，alpha = 0.2.1-alpha.1。

支持矩阵

检查项 · 结果

插件依赖的 DSH 接口 · ① ctx.skills.registerProvider(...)（技能提供者注册）② dsh.bundle.patch（bundle 挂载自己的 cordis.patch.yml）

已发布版本数 · 承载接口的两个包 @deepseek-ai/dsh-skill 与 @deepseek-ai/dsh-app-boot 各 31 个已发布版本

逐版本核对结果 · 31 / 31 全部一致，从最早的 0.0.1-rc.1 到最新的 0.2.1-alpha.1，接口签名与语义均未变

端到端实跑 · 把 lib/index.js 挂进本机 DSH 0.2.0-rc.2 的真实 SkillRegistry：list() 返回 15 个技能，逐个 get() 都能取到正文与 resourceBase

插件自身版本 · 0.4.0（技能内容同步自 obra/superpowers v7.0.1）

运行时依赖 · 无。只用 Node 内置模块，不引入任何第三方依赖，因此不受 DSH 依赖树变化影响

Node.js · 本机验证 v22.22.2；DSH 自身未声明 engines，本插件也未限制

已知兼容性说明

• 无已知不兼容问题。 上游 DSH 从 0.1.7-rc.2 起加入插件兼容性闸门

evaluatePluginCompatibility：它**只检查插件自己声明的 @deepseek-ai/dsh*

peerDependencies**，范围不满足就把整个 bundle 跳过并报错。本插件不声明任何

peerDependencies，因此这道闸门不会拦截它（同时它也意味着 DSH 不会替你校验版本，

所以升级 DSH 后建议跑一次下面的复核命令）。

• 同名技能的优先级是有意选择：插件以 PACKAGED_SKILL_RANK = 550 注册，DSH 内置

bundled 根为 BUNDLED_SKILL_RANK = 600（数值越小越优先），所以**同名时你自己的技能

会覆盖本插件的同名技能**。DSH 内置技能里没有与本插件重名的技能。

• Windows 提示：技能正文里的 bash 辅助脚本需要 Git for Windows（Git Bash）；Node

脚本（server.cjs、render-graphs.js）全平台可用。技能正文已按"经解释器调用"

（bash scripts/...）编写，不依赖 Unix 可执行位。

• 安装方式不影响兼容性：npm 包、GitHub 源、本地目录链接三种安装方式加载的是同一份

bundle 声明。

兼容性怎么复核

一条命令，对着你本机安装的 DSH 复跑上面全部检查（包括真实注册表挂载）：

node scripts/check-dsh-compat.mjs
# 也可指定别的 node_modules，或用 $DSH_NODE_MODULES
node scripts/check-dsh-compat.mjs D:\path\to\profile\node_modules

本机实测输出：

dsh SDK      : @deepseek-ai/dsh-skill 0.2.0-rc.2
mounted      : 15 skills listed and read through the real SkillRegistry
rank         : PACKAGED_SKILL_RANK=550 is below BUNDLED_SKILL_RANK=600

check-dsh-compat: OK — this plugin matches the installed DSH SDK

它依次检查：SDK 是否存在及版本 → 已安装 SDK 的类型声明里是否仍声明本插件实现的接口

（registerProvider、SkillProvider.list/get、SkillCandidate、SkillResourceBase、

'custom' 来源桶）→ 把 lib/index.js 真的挂进 SkillRegistry 并逐个读回 →

比较 rank 关系。任一项不成立就 exit 1，并指出具体是哪条契约变了。

在没有安装 DSH 的机器上（例如 CI、干净容器）没有可比对的对象，它会打印

SKIPPED 并 exit 0——这是"没检查"，不是"检查失败"（发布流程因此不会被误拦）。

显式传目录或以 --require 运行时，找不到 SDK 仍按错误处理。想强制要求先装 SDK：

DSH_COMPAT_REQUIRE=1 node scripts/check-dsh-compat.mjs。

结论以验证时的 DSH 版本为准。如果你跑的是更新的 DSH，先跑一遍上面的命令；

上游一旦改动技能接口，它会立刻报出具体变化，而不是等到技能悄悄消失。

技能列表

技能 · 用途

using-superpowers · 如何查找和使用技能；入口技能

brainstorming · 动手前先问清「你到底想要什么、为什么」，理解后再定规模和做法

writing-plans · 根据规格编写全面的实施计划

executing-plans · 本会话内（Native/内联）执行计划，末尾一次整分支评审

subagent-driven-development · 每个任务派发全新子代理并评审

dispatching-parallel-agents · 把独立工作扇出到并行代理

systematic-debugging · 先找根因的调试纪律

test-driven-development · RED-GREEN-REFACTOR 实施循环

verification-before-completion · 声称成功前先拿出证据

requesting-code-review · 合并前获得严格评审

receiving-code-review · 核实反馈，而不是盲目照做

finishing-a-development-branch · 安全地整合已完成的工作

using-git-worktrees · 功能开发的隔离工作区

writing-skills · 以 TDD 方式编写并验证新技能

diagnosing-superpowers · 会话出问题时读磁盘上的 transcript，带 `path:line

…(truncated)