一句话定位

为 DeepSeek Harness (DSH) 打包的 14 个 AI 协作技能合集：把 obra/superpowers（Claude-Code 上的 TDD、调试、规划、子代理派发等技能库）原样移植到 DSH 的 Cordis 插件架构上，安装后所有 agent 会话都能在技能目录里看到并加载它们。

核心能力

• 注册 14 个 DSH 技能，覆盖头脑风暴、写计划、执行计划、子代理派发、TDD、系统化调试、代码评审、worktree 隔离工作区等流程
• 把上游 Claude-Code 工具映射到 DSH 对应工具（subagent、subagent_fork、workflow、goal 等），无需修改调用方式
• 通过 Cordis bundle 层把技能挂到 host 注册表，每个 agent preset 的作用域链自动合并
• 自动发现 skills/<name>/SKILL.md：往包里丢新文件即新增技能，无需改任何代码
• list() 只扫目录、get() 按需读正文，懒加载避免一次性解析全部技能
• 为每个技能返回目录型 resourceBase，使技能内引用的脚本和提示模板路径能正确解析

技术实现

• 语言: JavaScript (ESM)
• 关键依赖: 无运行时依赖（仅 node:fs/promises、node:url、node:path 三个内置模块）
• 架构模式: Cordis 插件 + ctx.skills.registerProvider()，在 dsh-base 层之上通过 cordis.patch.yml 插入一行（id: superpowers-dsh）作为 host-plane bundle；list() 返回候选、get() 按需加载 SKILL.md 正文
• 入口文件: lib/index.js

适用场景

当你希望 DSH agent 在写代码前先做头脑风暴、调试时不跳过根因分析、提交前跑代码评审、复杂任务拆给子代理并行处理——但又不想为每个项目手写提示词时，装这一个插件就够。它适合中等规模以上、需要长期维护的项目，尤其在团队对工程纪律要求高但 prompt 不统一时收益最大。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:LayneChai/superpowers-dsh

配置项

本插件无需额外配置。技能正文、技能列表、注册行为全部由包内文件决定，不需要任何环境变量、配置文件或 Schema 字段。

常见问题

Q: 安装后为什么看不到技能？

A: 插件层在 profile 启动时挂载。安装后必须重启 dsh web（或 npx @deepseek-ai/dsh web）并刷新浏览器，再用 dsh --profile web --dump-config 检查输出里有没有 superpowers-dsh 行。

Q: 它和 DeepSeek Harness 自带的技能冲突吗？

A: 不冲突。它用 source: 'custom'、rank: 550 注册，低于内置 root 技能目录，作用域链是合并而非覆盖。

Q: 能新增或修改技能吗？

A: 可以。从文件夹或 file: 规格安装时是链接安装，往 skills/<kebab-name>/SKILL.md 丢一个新文件（开头带 YAML frontmatter：name + description，可选 whenToUse），下次重启 profile 就会被自动发现，不需要改任何 JS 代码。

Q: 这个插件会读写本地数据或联网吗？

A: 不会。它只读取自身包内的 SKILL.md 文件并把技能定义注入到宿主技能注册表，没有持久化存储、不会发起额外网络请求。

Q: 支持 Windows 吗？

A: 插件主体用 Node 内置模块，Windows 上完全可跑；但 brainstorming 技能附带的 .sh 辅助脚本是 bash 专用，Windows 原生命令行用不了，需要 WSL 或 Git Bash。

Q: 安装需要 npm 账号或 2FA 吗？

A: 不需要，就是一次普通包下载，发布到 npm 后国内会同步到 npmmirror。

Q: 和上游 obra/superpowers 有什么区别？

A: 三点主要差异：去掉命名空间前缀（superpowers:brainstorming → brainstorming）；using-superpowers 重写为对接 DSH 的 skill 工具；Claude-Code 专用工具替换为 DSH 的 subagent / subagent_fork 等。

Q: 如何卸载？

A: 执行 dsh plugin --profile web remove superpowers-dsh，然后重启 profile 即可。

上手难度

入门 — 安装一条命令、重启一次就生效，不改任何项目文件；想自定义技能时只需在 skills/ 下加 markdown，零代码门槛。

已知问题与限制

• brainstorming 技能附带的 .sh 视觉伴侣脚本仅限 bash 环境，Windows 原生 shell 无法直接运行（Windows 下需使用 Node 版的 scripts/server.cjs 或 WSL/Git Bash）
• 插件的 rank 固定为 550，无法通过用户配置调整优先级——若与未来更高 rank 的同名技能冲突，需要修改 lib/index.js 后重新打包
• YAML frontmatter 解析只覆盖 scalar 字段（name / description / whenToUse），列表或嵌套结构不会被展开，但其他字段会以 metadata 透传

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 的插件包。安装后会把下面的 14 个技能注册进 host 技能注册表，你 profile 里的每个 agent 会话都能在技能目录中看到它们， 并可用 skill 工具加载。

最简单：一条命令

不需要先全局安装 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——安装只是普通的包下载

技能列表

工作原理

• Bundle 层 —— cordis.patch.yml 在 dsh-base 层之上插入一行 （- id: superpowers-dsh, name: superpowers-dsh）。后面的层（profile 的 cordis.patch.yml、--patch 叠加）仍可按 id 定位这一行。
• 提供者 —— lib/index.js 调用 ctx.skills.registerProvider(...)， 注册一个提供者：
  • list() 扫描包内 skills/ 目录，把每个 <name>/SKILL.md 作为候选， 从 YAML frontmatter 解析出 name、description、whenToUse。
  • get() 按需读取候选技能正文，返回完整技能定义，resourceBase 指向 技能所在目录，使相对引用（脚本、提示模板）可以正确解析。
• 零运行时依赖 —— 插件只使用 Node 内置模块，消费注入的 ctx.skills 服务接口。

移植说明（对比上游 obra/superpowers）

• 去掉了命名空间前缀：superpowers:brainstorming → brainstorming （DSH 技能用裸名称寻址）。
• using-superpowers 现在介绍 DSH 的 skill 工具，并指向 skills/using-superpowers/references/dsh-tools.md——完整的 Claude-Code → DSH 工具映射（pwsh、subagent、workflow、goal ...）。
• 子代理引用映射到 DSH 的 subagent / subagent_fork 工具。
• brainstorming 的视觉伴侣补充了 Windows 说明：Node 服务 （scripts/server.cjs）全平台可跑；.sh 辅助脚本仅限 bash。

添加自己的技能

往包里放一个新的 skills/<kebab-name>/SKILL.md 即可——它必须以 YAML frontmatter 开头（name + description，可选 whenToUse）。无需改任何 代码：list() 会自动发现它。

许可证

MIT。技能内容改编自 obra/superpowers（MIT），© Jesse Vincent 及贡献者。