icanfinish11/dsh_superpowers

dsh-superpowers

DeepSeek Harness（dsh）的 Superpowers。 安装它，你的 dsh 智能体就会获得全部 14 项
Superpowers 技能——头脑风暴、规划、TDD、
调试等等——并且会自动使用它们：当任务匹配某项技能时，智能体会在行动前
加载它。

捆绑的技能树固定到一个记录在案的上游修订版本——package.json 中的 upstream.tag 和
upstream.commit（当前为 v6.3.0、
b36e0829c6d0140e93cfef2ca599b1b07d4a7797）——并且可重新同步：
npm run sync-skills --check 会报告该副本相对于更新的检出偏离了多少
（按文件报告，非零退出码），以及该检出是否仍与记录的固定版本匹配，而
npm run sync-skills 会采用更新的技能树，同时保留此适配器自身的附加内容。在版本之间，
模型脚下不会有任何东西发生变化，也不会有任何东西悄悄漂移。

有两部分实现了这一点：

1. 这些技能被添加到 dsh 的技能目录中，因此智能体能看到它们，并用 dsh 自带的 skill
工具加载其中任意一项。每项技能保留自己的目录，因此它所引用的脚本、
提示词和模板都能解析到其真实位置。
2. 一段简短的“你拥有 superpowers”引导语被添加到系统提示词中，因此这些技能
会在每个会话的第一轮就触发——无需设置，无需按会话选择加入。

该包没有依赖项，也不需要构建步骤。技能随包一起分发：
skills/ 是上游 Superpowers 技能树在 package.json 中所记录标签
（upstream.tag）处的逐字副本，外加此适配器自有的 references/dsh-tools.md 以及
skills/using-superpowers/SKILL.md 中的一行 dsh 指引。上游采用 MIT 许可，Copyright (c)
2025 Jesse Vincent——参见 LICENSE.superpowers 和
references/CREDITS.md。npm run sync-skills 会根据更新的上游检出
重新同步该技能树，并报告漂移情况。

捆绑是有意为之：github:obra/superpowers 依赖会使技能来源成为一个
外部子依赖，而 pnpm 拒绝安装它
（ERR_PNPM_EXOTIC_SUBDEP: Exotic dependency "superpowers" (resolved via git-repository) is not
allowed in subdependencies）——每个用户的安装都会失败。直接分发技能树可以让
dsh plugin add 成为一次普通的、可离线完成的安装。

安装

要求：一个可用的 dsh 安装（dsh plugin，以及位于 PATH 上的应用）和 Node 18 或
更新版本。该适配器无依赖且为纯 JS，因此安装永远不会触发 pnpm 的构建
批准，并且除了仓库本身之外不需要网络。

从 GitHub（规范来源）——仓库为 icanfinish11/dsh_superpowers；
它安装的包为 dsh-superpowers
dsh plugin --profile web add icanfinish11/dsh_superpowers

从本地检出安装
dsh plugin --profile web add link:/path/to/dsh_superpowers

dsh plugin 会在 $DSH_HOME/profiles// 内运行 pnpm，然后协调该 profile：
该包在其 package.json 中声明了 dsh.bundle，因此它会被追加到
dsh.profile.bundles 及其 cordis.patch.yml 会被分层合并到组合配置中。
这些技能来自已安装包内部的副本——不会获取任何其他内容。

之后请重启 harness——bundle 补丁在启动时读取。

验证：

dsh --profile web --dump-config | grep -A6 superpowers     # the mounted row
dsh --profile headless "In one short sentence: do you have superpowers, and name two skills."

然后，在一个会话中：

dsh --profile headless "Let's make a react todo list"

首先应该发生的是 brainstorming 技能加载——在任何代码之前。

你会得到什么

| Superpowers 组件 | dsh 对应面 |
|---|---|
| skills/（14 个技能） | ctx.skills.registerProvider(...)——每个 //SKILL.md 对应一个候选，resourceBase 设置为技能目录，rank 为 600 |
| using-superpowers 引导 | ctx.systemPrompt.section({ name: 'superpowers:bootstrap', order: 121 })，从第一轮起就组装进每个请求 |
| SessionStart 钩子（Claude Code） | 不使用。dsh 没有 session-start 钩子通道；系统提示注册表是其始终在线的贡献点，而且 section 不会像注入的历史消息那样因压缩而丢失 |
| 工具映射（references/-tools.md） | references/dsh-tools.md，以及内联到引导中的相同映射，这样模型无需读取文件即可获得它 |
| 子代理、待办事项、工作树、TDD | dsh 自有的工具：subagent / subagent_fork、todo_write、pwsh / bash、read / write / edit、grep / glob、web_search |

这些技能来自哪里

本包中的 skills/ 是 Superpowers 技能树，在 package.json 中的标签处（upstream.tag，当前为 v6.3.0）从上游复制而来，并带有两项 dsh 自有的新增内容：

- skills/using-superpowers/references/dsh-tools.md——此适配器的工具映射，
- skills/using-superpowers/SKILL.md 的“Platform Adaptation”列表中的一行，将 dsh 指向该文件（Superpowers 移植指南允许的唯一一处 SKILL.md 编辑）。

技能根目录在加载时按以下顺序解析，第一个包含 using-superpowers/SKILL.md 的候选者胜出：

1. 插件的 skillsDir 配置
2. SUPERPOWERS_SKILLS_DIR 环境变量
3. 本包内的 skills/——常规路径
4. 本包旁边的 ../skills——当开发副本与 Superpowers 检出目录相邻时很有用
5. 作为依赖解析的 superpowers 包的 skills/ 目录（如果该 profile 中安装了的话）

如果什么都无法解析，插件会记录一条警告并降级为仅引导模式；它绝不会导致 profile 启动失败。

采用新的上游版本

git clone --depth 1 --branch vX.Y.Z https://github.com/obra/superpowers /tmp/superpowers
node scripts/sync-skills.mjs /tmp/superpowers --check   # report drift, write nothing
node scripts/sync-skills.mjs /tmp/superpowers           # re-copy, keeping the dsh additions
然后更新 package.json 中的 version、upstream.tag 和 upstream.synced，检查
diff，并运行测试。同步脚本会保留 references/dsh-tools.md，并在上游的该文件副本缺少
平台指针时重新应用它。

配置

该补丁将该行挂载为 id: superpowers。可在
$DSH_HOME/profiles//cordis.patch.yml 中按 profile 覆盖它（补丁层会替换该行的整个配置，
因此请重新声明你想保留的每个键）：

- id: superpowers
config:
skills: true          # 注册技能目录
bootstrap: true       # 注入 using-superpowers 引导
toolMapping: true     # 将 dsh 工具映射追加到引导
order: 121            # 系统提示词区段顺序
skillsDir: ''         # 空 = 自动解析

| 键 | 默认值 | 含义 |
|---|---|---|
| skills | true | 将技能目录注册为技能提供者。 |
| bootstrap | true | 贡献 superpowers:bootstrap 系统提示词区段。 |
| toolMapping | true | 将 dsh 工具映射追加到引导。 |
| order | 121 | 区段顺序；dsh 按升序渲染（100–199 是工具/行为区间）。 |
| skillsDir | '' | 显式技能根目录；为空时自动解析。 |

更新

dsh plugin --profile web add link:/path/to/dsh_superpowers   # 本地更改后重新链接

对于更新的 Superpowers 版本，使用上面的同步流程；对于更新的适配器版本，
重新安装并重启 harness（bundle 层在启动时读取）。

测试

node tests/test-plugin.mjs         # 或：npm test / bash tests/run-tests.sh

该测试套件模拟 dsh 的 skills 和 systemPrompt 服务，因此无需安装 harness。它
验证提供者契约、捆绑的技能树、frontmatter 边界情况、引导
组装、工具映射以及降级路径。

故障排除

插件未加载

dsh plugin --profile web list

该包必须列在
$DSH_HOME/profiles/web/package.json 内的 dsh.profile.bundles 中；对于任何声明了 dsh.bundle 的
依赖项，dsh plugin add 会自动完成此操作。如果缺失，请移除并重新添加该包，然后
重启。

“skills directory not found”

插件无法解析技能根目录——已安装的包缺少其 skills/
树（部分检出或重新打包的构建）。改为将插件指向一个检出目录：

- id: superpowers
config:
skillsDir: /absolute/path/to/superpowers/skills

模型不知道它拥有 superpowers

该行已组合，但 bundle 层仅在启动时读取：重启 harness。然后检查
插件日志行（registered the Superpowers skill catalog from …）。

某个技能名称与我的技能冲突

dsh 按等级解析重复项，最近的层优先：项目根目录（100/200）和用户
根目录（400/500）都优先于此提供者（600），因此你自己的技能会保留该名称。

与仓库内移植版的关系

Superpowers 带有一个仓库内 dsh 移植版（.dsh-plugin/ + 根目录 cordis.patch.yml），因此
该仓库的一个分支可以直接安装，并且上游 PR 可以在那里发布集成。
本包涵盖另一种情况：一个自带技能的独立插件，因此它
仅从其自己的仓库安装。该插件模块是相同的代码，并解析两种
布局。

许可证

MIT — 参见 LICENSE。捆绑的技能树是 Superpowers，MIT，Copyright (c) 2025
Jesse Vincent — 参见 LICENSE.superpowers 和
references/CREDITS.md。