超能力技能包 dkeviv/dsh-superpowers-verified

dsh-superpowers-verified

Superpowers 的 fork，面向 DeepSeek Harness（DSH） —— 完整的 Superpowers 方法论（头脑风暴、规划、TDD、系统化调试、子代理驱动执行）已适配到 DSH 上运行，安装过程可验证、可回滚。

Superpowers 是 Jesse Vincent / Prime Radiant 提出的智能体软件开发方法论；本 fork 将它适配到 DeepSeek Harness。它与 Superpowers 项目、Prime Radiant 或 DeepSeek 均无关联，也未获其背书。

15 skills · DeepSeek Harness (DSH) · 86 tests · live-catalog verification · non-destructive install

关键词： Superpowers fork for DeepSeek Harness · DSH skills · obra/superpowers port · DeepSeek coding agent skills · TDD · subagent-driven development · agentic workflow for DSH · superpowers-dsh alternative · DeepSeek Harness 技能包 · 超级技能

安装

git clone https://github.com/dkeviv/dsh-superpowers-verified.git
cd dsh-superpowers-verified
./bin/install.sh --dry-run # see exactly what will change
./bin/install.sh

然后开一个新 DSH 会话，发送 Let's make a react todo list。安装成功的话，它会调用 brainstorming，先问清楚你到底想要什么，再动手写代码。

卸载会精确还原：

./bin/install.sh --uninstall

为什么会有这个 fork

Superpowers 的技能大多与具体 harness 无关，但有两样东西搬到 DSH 上会失效，本 fork 补上了它们：

1. DSH 没有会话启动钩子。 上游通过 SessionStart 钩子注入 using-superpowers（Claude Code、Codex、Cursor、Gemini、Muse、Pi……）。DSH 的 dsh-hooks- 包是向其他 harness 提供钩子，而不是消费钩子。DSH 里对应的通道是用户级全局指令文件 $DSH_HOME/AGENTS.md，每个会话的每一轮都会加载——所以引导内容放进这里，包在自管理的标记之间。

2. DSH 的工具词汇不一样。 这里没有任何东西叫 Agent、Task、TodoWrite 或 Skill。DSH 提供的是 skill、todo_write、subagent/subagent_fork/workflow、原生 plan 模式，以及文件沙箱。references/dsh-tools.md 就是这层翻译。上游的平台适配清单已重写，只提 DSH：留下的 Claude Code 参考文件讲的是嵌套子代理深度调优，以及一个 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 变量，这些在这里都不存在。

3. DSH 技能名不带命名空间。 上游用 superpowers:writing-plans 这样的写法交叉引用自己的技能，但 DSH 直接拒绝技能名里出现冒号，所以那些引用照原样写根本解析不了。见已知限制 —— 这是本分支唯一记录在案、而非悄悄打补丁绕过的上游不兼容点。

本分支有何不同

面向 DSH 的 Superpowers 移植有好几个。这一个围绕两点来构建，而不是围绕功能：

对照真实目录验证，而不是对照文字描述。 bin/verify.sh 挂载 DSH 自己的技能注册表和文件系统服务商，问清楚到底什么能解析出来 —— 然后逐一检查。围绕它，tests/run.sh 有 86 项检查，覆盖快照完整性、与内置副本的一致性、幂等性、恶意 AGENTS.md 输入、迁移路径和卸载，另有一套 GitHub Actions 矩阵跑在 Ubuntu 和 macOS 上。多数移植只是声称兼容 DSH；这一个拿出证据，一旦不成立就大声报错。

安装过程不会弄坏你的环境。 整套测试跑在一个一次性前缀里，绝不碰你真正的技能根目录或 AGENTS.md。安装器只掌管自己标记之间的区域，保留你自己写的 AGENTS.md 内容，只追加不重排，卸载时精确移除自己装过的东西。更新就是 git pull && ./bin/install.sh —— 幂等，跑两遍也安全。

快照固定版本、可审计。 技能是上游在某个确切 commit 上的内置副本（vendor/superpowers/README.md），所以安装可离线、可复现，也能和上游做 diff。所有 DSH 专属代码都放在 vendor/ 之外。

| | 本分支 | 常见 DSH 移植 |
| 安装机制 | 文件系统安装器，写入 DSH 原生技能根目录 | Cordis 插件包，通过 dsh plugin add 安装 |
| 兼容性证据 | 86 项检查套件 + 实时目录验证器 + 双系统 CI | 文字声称 |
| 安装可逆性 | 标记块归属，精确卸载 | 各不相同 |
| 上游技能 | 固定 commit，内置 | 通常在构建时同步 |

插件包方案更贴合 DSH 内部机制；文件系统方案不需要插件层，每一处改动都能在你自己的配置里审阅。按你运行 DSH 的方式挑一个合适的。

你会得到什么

全部 15 个 Superpowers 技能：

| 技能 | 用途 |
| using-superpowers | 入口：如何找到并使用技能 |
| brainstorming | 动手构建前先挖出真实意图 |
| writing-plans | 把已批准的设计拆成小块任务 |
| executing-plans | 内联执行计划，最后统一评审一次 |
| 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 | 编写并测试新技能 |
| diagnosing-superpowers | 根据会话记录做复盘 |

选项

| 选项 | 作用 |
| --target <dir> | 技能根目录（默认 $DSH_AGENTS_HOME/skills 或 ~/.agents/skills） |
| --dsh-home <dir> | DSH home，存放 AGENTS.md（默认 $DSH_HOME 或 ~/.dsh） |
| --no-skills / --no-bootstrap | 只做其中一半 |
| --dry-run | 打印将要做的改动，不写入任何内容 |
| --uninstall | 反向执行安装 |

验证

两件独立的事，都可以重复运行：

tests/run.sh # 86 checks, offline, no writes outside a temp dir
bin/verify.sh # audit a LIVE install against DSH's own skill catalog

bin/verify.sh 才是重点。它不去读你的文件然后猜——它在一个裸 Cordis 上下文里挂载 DSH 真正的技能注册表和文件系统服务商（和运行中的 harness 用的是同一份代码），请求解析后的目录，然后核对结果：

$ ./bin/verify.sh
Verifying Superpowers for DSH
modules: /Users/you/.npm/_npx/…/node_modules skills: /Users/you/.agents/skills AGENTS: /Users/you/.dsh/AGENTS.md

✓ catalog resolves completely 22 skills
✓ every vendored skill resolves from --target 15/15 at …/.agents/skills ✓ no resolved skill name uses a namespace ✓ every installed skill has a loadable name ✓ no skill is shadowed by $DSH_HOME/skills ✓ DSH reference file installed ✓ adaptation list names DSH ✓ no other harness is advertised ✓ namespace workaround is documented ✓ bootstrap present in AGENTS.md one balanced block ! upstream namespace references 46 references use superpowers:<name>; agents must strip the prefix

10 passed, 1 warnings, 0 failed

真出问题时它会以非零状态退出，所以能用在 CI 或 pre-commit 钩子里。它能抓到的问题包括：某个技能装了却解析不出来（包括因名字不合法被 DSH 悄悄跳过的情况）、某个技能被优先级更高的根目录遮蔽、平台列表被改回上游版本、bootstrap 标记不成对、参考文件缺失，等等。

选项：--target、--dsh-home、--modules <node_modules>、--json。如果找不到 DSH 包，它会直接说明并以 2 退出，而不是报一个误导性的通过——自动检测失败时，设置 DSH_NODE_MODULES。

目录结构

bin/install.sh installer / uninstaller
bin/verify.sh audits a live install against the real catalog
lib/dsh-resolve-skills.mjs mounts DSH's skill registry standalone
lib/session-start.sh generates the bootstrap block
lib/patch-using-superpowers.mjs rewrites the skill's platform-adaptation list
references/dsh-tools.md the DSH harness reference (installed into the skill)
vendor/superpowers/ unmodified upstream snapshot (MIT, pinned commit)
tests/run.sh 86 项端到端检查套件 docs/install.md 安装、更新、故障排查说明

已知限制

- npx skills update 会抹掉 DSH 适配。 skills 命令行是同一个技能根目录的第二个独立所有者，它没有这个 fork 能用的钩子。通过它更新 Superpowers 会原样重新复制上游内容：平台列表恢复成全部六个 harness，references/dsh-tools.md 被删除，其他 harness 的参考文件又回来了。这种情况会被检测并修复——重新运行 ./bin/install.sh 即可修复，./bin/install.sh --check 会报告问题但不写入：

bash
./bin/install.sh --check # exit 1 + the fix command if it was clobbered
./bin/install.sh # repairs it, warns while doing so

如果你经常运行 npx skills update，把 --check 放进钩子。校验器（bin/verify.sh）遇到这种状态也会失败，并给出修复方法。
- 跨技能引用保留了上游的命名空间前缀。 11 个技能文件里有 41 处引用写成 superpowers:writing-plans 之类。DSH 的 isSkillName 拒绝冒号，所以 skill({name: "superpowers:writing-plans"}) 会报 invalid skill name 失败。这个 fork 刻意不改写它们：改写意味着编辑 vendored 技能正文，而这正是那种会让 fork 在下一次重新 vendor 时变得不可信的静默分歧。取而代之，规则写在 references/dsh-tools.md 里——去掉前缀，加载裸名称——这样智能体就能解析它们，而文件不会分歧。如果你更想要机制而不是约定，PATH 上一个名为 superpowers:writing-plans 的包装脚本也能吸收冒号。
- 没有 worktree 工具。 DSH 没有托管 git 集成，所以 using-git-worktrees 走它的 git worktree 回退路径。在 workspace-write 沙箱下，把 worktree 创建在 workspace 内部。
- diagnosing-superpowers 需要 zstd。 DSH 把会话记录存成 session.v4.jsonl.zstd；没有解压器，会话发现就读不了它们。布局和命令在 references/dsh-tools.md 里。
- 压缩后不会重新注入 Bootstrap。 技能目录*每轮都会重发，所以技能继续工作，但自动触发在很长的会话深处会逐渐失效。
- Vendored 快照，不是实时流。 技能在你 git pull 并重新运行安装器时更新。见 vendor/superpowers/README.md。

致谢与许可

MIT —— 见 LICENSE 和 NOTICE。

vendor/superpowers/ 里的 vendored 技能是 Copyright (c) 2025 Jesse Vincent，MIT 许可，未修改，转载于 vendor/superpowers/LICENSE。Superpowers 由 Jesse Vincent 和团队打造 Prime Radiant —— 这里的方法论全部出自他们；这个分支只改了它在 DeepSeek Harness 上的运行方式。

上游： https://github.com/obra/superpowers · MIT ·文档 · Discord