dsh-superpowers-preset
作为 DeepSeek Harness 代理预设的 Superpowers：将完整的 obra/superpowers 工程方法论整合到一个可选择的模式中，其技能和工作流规则均限定在该模式内。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:EdouardRichard/dsh-superpowers-preset#8266f1eb31b027e94ce4f7626ff4eac4e4387773Superpowers Preset 以 dsh-superpowers-preset 发布，当前版本为 1.0.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 | English
把 obra/superpowers 的完整开发方法论， 做成一个 DeepSeek Harness (DSH) Agent 预设。
按需选择、按任务生效：流程约定进系统提示词，技能目录只在这个模式里可见。
把 Superpowers 作为插件装进 DSH，技能会注册到 host 层，于是每一个会话 ——包括跟编码无关的、用别的工作流的——系统提示词里都会多出这份技能目录。这既 是 token 开销，也可能和其他工作流打架。
这个项目换了一条路：把 Superpowers 做成 Agent 预设（也就是 DSH 界面里的 「模式」）。
| 插件模式 | 本预设 | |
|---|---|---|
| 谁能看到这些技能 | profile 里所有会话 | 只在这个模式里启动的任务 |
| 没用上时的技能目录 token | 每个会话都要付 | 0 |
| 流程约定怎么进模型 | 取决于插件（会话开始时注入，或只靠技能描述） | 本模式的系统提示词，每次请求都重新发送 |
| 上下文压缩之后 | 会话开头注入的内容可能被裁掉 | 不受影响：系统提示词不在会话历史里 |
| 怎么关掉 | 停用/卸载插件并重启 | 新建任务时选别的模式 |
两种方式回答的是不同的问题，没有优劣之分，取舍详见 与插件模式的对比。
先澄清一个用词。 DSH 里的
dsh plugin add是安装通道，它装进去的东西 叫 bundle——一个带dsh.bundle.patch的普通 npm 包。bundle 装完之后运行成 什么形态，完全由它那份 patch 的内容决定。本包只往 profile 的组合里插了一行 agent-preset 声明，没有把任何东西挂到 host 层。所以准确说法是"用插件通道安装的预设"，而不是"插件"。这个包自己写 的代码只有一个
lib/skills.js，它作为预设的子行被挂载，因此注册进的是预设 自己的技能层。为什么要这样做，见工作原理。
在 DSH 里新建对话，把这句话发给它：
帮我安装这个插件：https://github.com/EdouardRichard/dsh-superpowers-preset
它会调用 dsh plugin ... add 完成安装并验证组合。但它不能替你重启 profile
——重启会终止它自己所在的会话。所以装完你要手动重启并刷新浏览器。
前提：Agent 能找到一个可用的
dsh。如果你的dsh没有加到PATH， 把下面方式二里的完整命令直接发给它更稳妥。
# 从 GitHub 安装
dsh plugin --profile web add github:EdouardRichard/dsh-superpowers-preset
dsh 没有在 PATH 里时，用 npx 跑同一个 CLI：
npx --yes @deepseek-ai/dsh plugin --profile web add github:EdouardRichard/dsh-superpowers-preset
⚠️
npx默认取 npm 的latest标签，它可能落后于你正在运行的 harness（例如 npm 上latest = 0.2.0-rc.2，而你在跑0.2.1-alpha.2）。 版本对不上时显式指定，例如npx --yes @deepseek-ai/dsh@0.2.1-alpha.2 plugin ...。 用 pnpm 的话，pnpm dlx @deepseek-ai/dsh@<版本> plugin ...等价。
--profile 换成你实际用的 profile（web / headless / 自定义）。profile 不存在时
会被自动初始化。
git clone https://github.com/EdouardRichard/dsh-superpowers-preset
dsh plugin --profile web add ./dsh-superpowers-preset
相对路径按你执行命令时所在的目录解析，安装后记为该目录的绝对 link。本地目录是 link 安装（不是复制），改完这个目录重启 profile 就生效，方便自己改。
bundle 层在 profile 启动时挂载，所以要重启 profile（关掉再跑一次
dsh web），然后刷新浏览器。
dsh --profile web --dump-config | Select-String dsh-superpowers-preset
输出里应该能看到 - id: preset-superpowers 这一段，以及
name: dsh-superpowers-preset/skills 这一行。看到这两行说明层已经组合进
profile；重启后新建任务时就能在模式列表里选到「Superpowers」。
dsh plugin --profile web remove dsh-superpowers-preset
卸载同样需要重启 profile。
新建任务，在输入框上方把模式切到 Superpowers，然后正常描述任务即可。
skill 工具把它加载进来再动手"。/brainstorming、/writing-plans、/test-driven-development
这样的斜杠命令，或直接说"用 TDD 做"。DSH 内置的四个预设（标准 / PTC / 极简 / 创造）卡片上有「模式说明」和
「如何使用」两个按钮。第三方预设拿不到这两个按钮——这是 DSH 当前的实现
决定的，不是配置问题：帮助内容的查找只对 trust === 'system' 的内置预设开放，
而且只有 id 在写死的四个值里才会命中（见
证据与说明）。
所以这两块内容放在了文档里，并且随包分发：
下面是精简版。
工作方式：Superpowers 的 15 个技能被注册进这个预设自己的技能层，
using-superpowers 的正文作为本模式的 persona 进入系统提示词。计划模式、
子 Agent、工作流、目标、上下文压缩、终端、文件读写检索都在，所以这个模式
可以独立完成从想法到提交的全过程。
五个阶段：想清楚（brainstorming）→ 写计划（writing-plans）→
执行（subagent-driven-development / executing-plans）→
排障（systematic-debugging / test-driven-development）→
收尾（verification-before-completion / requesting-code-review /
finishing-a-development-branch）。
什么时候选：要交付代码的功能开发、缺陷修复、重构；希望 Agent 先把需求和 设计谈清楚；任务长到需要计划和台账。
什么时候别选：和编码无关的问答与资料整理（用标准模式，省 token）； 只想快速改一行；需要实验对照基线（用极简模式）。
选好模式，直接描述任务。例如：
我想给这个 CLI 加一个「导出为 CSV」的功能，但还没想清楚参数怎么设计。先跟我把需求和边界聊清楚，给我两三个方案对比，我确认之后再写代码。
提交订单后偶尔会出现重复扣款。先定位根因，别急着改；找到之后先写一个能复现的失败测试，再修，最后跑相关测试并说明原因。
审查我这次分支的改动，重点看潜在 bug 和测试缺口，指出文件与行号。先不要改文件。
每个例子都写清了预期产出，完整的六组示例见 如何使用。
技能内容同步自上游 obra/superpowers v6.4.2，并按 DSH 重写了涉及工具、 路径、子 Agent 与脚本调用的说明。
| 技能 | 用途 |
|---|---|
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 | 以 TDD 方式编写并验证新技能 |
diagnosing-superpowers | 读磁盘上的会话记录，用 文件:行号 取证复盘 |
一句话：cordis.patch.yml 往 profile 的组合里插入一行 agent-preset
声明；这一行里挂的 skill provider 是 dsh-superpowers-preset/skills，所以它
注册进的是这个预设自己的作用域，而不是 host 全局层。
cordis.patch.yml
└── preset-superpowers (@deepseek-ai/dsh-agent-preset)
├── persona ← using-superpowers 正文进系统提示词
├── dsh-superpowers-preset/skills ← 15 个技能，只注册进本预设层
├── skill-filesystem ← 本地技能：项目 / 用户 / bundled
├── tool-skill ← 技能目录 + skill 工具
└── 其余全部照抄官方「标准模式」的那份清单
这一点是有保证的，不是大概齐。 DSH 会把一些实际可用的行在 host 层禁用，
改由每个预设自己挂载——最典型的是 skill-filesystem：官方补丁里写得很清楚，
"presets own local discovery"（packages/bundle/web-app/cordis.patch.yml:493-503）。
预设如果忘了挂它，就没有本地技能发现：项目里的 .dsh/skills、.agents/skills
和用户目录的 $DSH_HOME/skills 全部看不见，而且不会报错。
所以这里做了三重保障：
npm run sync:preset -- <dsh 源码目录> 直接从官方 standard 预设重建插件清单，
只保留本包自己的两行（persona 和 Superpowers provider），其余逐字节照抄。preset/standard-parity.json 记录官方预设携带的
每一行，并对每个顶层行块做 sha256；npm run verify 一旦发现少一行、或者某个
镜像行的 config / isolate / disabled / 嵌套子行被改过，就失败。sync:preset 会报错，而不是
悄悄用旧身份继续发布。DSH 0.2.1 起官方预设不再带 persona 后缀，本预设同样不带：
{{cwd}} 已不是注册过的提示词变量（只有 provider、model），带上它会让整个
模式的提示词组装失败——包括恢复已有会话时。升级 DSH 后重跑 npm run sync:preset -- <path> --check（只报告不改动），再
npm run verify。
这三处来自「本预设不是 DSH 内置预设」这个身份，任何插件都改不了：
| 方面 | 标准模式 | 本模式 |
|---|---|---|
| 分组 | 内置 | 自定义（isBuiltInPreset 只认不发布 name 且 id 在内置四个里的行） |
| 名称/描述 | 随界面语言本地化 | 声明里的字面量，不随语言变化 |
| 新任务默认 | 是 | 否——要在新建任务时手动选，或在设置里「设为新任务默认」 |
另外两点行为差异：
skill-filesystem 注册进同一层，层内按
rank 决定胜负（本地根 100–500，本包 550，bundled 600，数值小的赢），所以你
自己写的同名技能会盖掉打包的那份，DSH 会记一条 warning。完整说明（包括为什么 bootstrap 用 persona 而不是会话开始时的注入、为什么 provider 用子路径导出而不是包根）见 docs/architecture.md。
这个预设的每一行都可以被你自己的 profile patch 覆盖。例如改显示名、让它排在 别的模式前面，或者拿掉你不想要的工具：
# 追加到 $DSH_HOME/profiles/<你的 profile>/cordis.patch.yml
- id: preset-superpowers
name: '@deepseek-ai/dsh-agent-preset'
config:
id: superpowers
name: 超能力模式
description: 我的自定义描述。
order: 2
plugins:
# config 是整体替换，不是深合并：把上面 cordis.patch.yml 里那份
# plugins 列表原样抄过来，再按你的想法增删。
- id: persona
name: '@deepseek-ai/dsh-persona'
config:
prefix: |-
...同样原样保留，或者换成你自己的…
# ...
一个可以直接抄的骨架见 examples/profile-override.patch.yml。
skills/ 是生成产物，不要手改。同步逻辑全部写在脚本里，每条改写都带断言：
# 1. 取上游对应版本的源码
mkdir -p .upstream && curl -L \
https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.4.2 \
| tar -xz -C .upstream --strip-components=1
# 2. 重放移植（会顺带重新生成 cordis.patch.yml 里的 persona 正文）
npm run sync -- .upstream
# 3. 校验
npm run verify
上游一旦改了脚本依赖的原文，npm run sync 会直接报错并保持 skills/
不变，而不是静默丢掉某条 DSH 适配。适配清单见 NOTICE.md。
| 项目 | 状态 |
|---|---|
| 验证过的 DSH 版本 | 0.2.1-alpha.2（源码 checkout d7432673） |
| 依赖的 DSH 接口 | ctx.skills.registerProvider（技能提供者注册）、dsh.bundle.patch（bundle 挂载）、@deepseek-ai/dsh-agent-preset 声明格式、@deepseek-ai/dsh-persona |
| 运行时依赖 | 无。只使用 Node 内置模块 |
| peerDependencies | 不声明。DSH 的插件兼容闸门只检查插件自己声明的 peer 依赖，因此这道闸门不会拦截本包——代价是 DSH 也不会替你校验版本，所以升级 DSH 后请重跑 npm run verify |
| Node.js | >= 20（本机在 24.x 上验证） |
| 平台 | Windows / macOS / Linux。Windows 上 tool-pwsh 生效，POSIX 上 tool-bash 生效 |
subagent 接受 description /
prompt / cwd，没有 run_in_background——每次委派都已异步。预设的
tool-subagent 行开启了 modelSelectionSettings，因此部署暴露可选子模型时
subagent 也接受 provider / model / reasoning_effort，否则沿用会话设置。
subagent-driven-development 里"显式指定模型"的要求，在没有按次选择时写进
prompt；确实需要按单元指定模型时，改用 workflow（它的 agent() 接受
provider / model）。Task(superpowers:code-reviewer) 在 DSH 里不存在，
改为把技能自带的提示词模板（code-reviewer.md 等）交给 subagent。.sh 脚本需要 Git Bash。Windows 上 PATH 里的
bash 往往是 WindowsApps\bash.exe（0 字节的 WSL 存根），不是 Git Bash；
脚本调用前先 Get-Command bash -All 确认。node 脚本不受影响。writing-skills/render-graphs.js 需要 graphviz 的 dot，没装就跳过渲染。不需要安装就能跑的静态校验（CI 跑的也是它）：
npm run verify
它检查 bundle 清单能解析、预设声明合法、provider 只挂在预设作用域、官方 标准预设携带的每一行都还在、persona 正文与技能文件一致、15 个技能都能通过 真实 provider 列出并读回，以及没有悬空相对链接。
装进真实 profile 的端到端验证：
# 用一个一次性 profile，不要动你自己的
dsh --profile sptest --from-default-profile web --dump-config > $null
dsh plugin --profile sptest add ./dsh-superpowers-preset
dsh --profile sptest --port 3099 --no-open
然后在界面里分别用 Superpowers 和 标准模式 各起一个任务，对比会话记录：
using-superpowers 的正文，技能目录里有
这 15 个技能；MIT。技能内容改编自 obra/superpowers （MIT，© 2025 Jesse Vincent），完整的第三方声明、上游许可证原文与改编清单见 NOTICE.md。
上游项目、DSH、以及先行把 Superpowers 移植到 DSH 的 superpowers-dsh 都值得一看。 本项目与它们没有隶属关系。