超能力技能包 Wenaixi/dsh-superpower

dsh-superpower

obra/superpowers 的 DSH 移植版。15 个技能注入 ctx.skills，装上就能用；技能正文是上游英文原版，技能名保持上游英文原名，面板可切换每个技能在模型目录与斜杠（/）唤出技能栏中描述的中英文。

安装

需要 dsh 本体（已适配最新 v0.2.1-rc.2 / >=0.2.0-rc.2，安装命令：npm i -g @deepseek-ai/dsh），Node 与 pnpm 的版本要求见上方徽章。下面以 web profile 为例，换个 profile 名字即可。

A — npm（推荐，自动装最新）
dsh plugin --profile web add @wenaixi/dsh-superpower

B — GitHub 直装（绕过镜像延迟）
dsh plugin --profile web add github:Wenaixi/dsh-superpower

验证
dsh --profile web --dump-config | grep -A2 "@wenaixi/dsh-superpower"
== @wenaixi/dsh-superpower / - id: superpowers

dsh --profile web # 进会话，技能自动可用

要锁版本就在包名后加 @<version> 或 #v<version>（具体版本以 npm view @wenaixi/dsh-superpower version 当前发布为准）。

本地开发或离线安装：

git clone https://github.com/Wenaixi/dsh-superpower && cd dsh-superpower
pnpm install && pnpm build && node scripts/verify.mjs # 末行打印 ALL PASS
dsh plugin --profile web add ./ # 本地路径安装
pnpm pack && dsh plugin --profile web add ./wenaixi-dsh-superpower-.tgz

更新 / 卸载
dsh plugin --profile web add @wenaixi/dsh-superpower
dsh plugin --profile web remove @wenaixi/dsh-superpower

是什么

一套工程纪律：先设计，再把计划切成可校验的小步，然后测试驱动，调试时先找根因，收尾前必须跑验证命令。技能正文是上游英文原版，frontmatter 同时声明英文 description 与中文 description_zh，面板的语言开关只决定模型与用户看到哪一份描述，不改正文。

装在 dsh.bundle 里，不往用户目录写东西，卸载干净，HMR 会自动重建。

包含技能

| 技能 | 什么时候用 |
| using-superpowers | 每次会话开头，先查有没有该用的技能 |
| brainstorming | 新功能动手前，把需求和设计问清楚 |
| writing-plans | 设计定了，拆成一项一项能验证的任务 |
| using-git-worktrees | 需要和当前工作区隔离 |
| executing-plans | 在当前会话里亲自把计划跑完 |
| subagent-driven-development | 计划里有多件独立的事，交给 subagent 分头做 |
| dispatching-parallel-agents | 两件以上互不依赖的事并行分发 |
| test-driven-development | 先写测试再写实现 |
| systematic-debugging | 出了 bug，先定位根因再改 |
| verification-before-completion | 说「完成」之前必须跑验证命令 |
| requesting-code-review | 任务做完、发 PR 前求评审 |
| receiving-code-review | 收到评审意见，先技术核实再改 |
| diagnosing-superpowers | 会话出问题或成本异常时定位原因 |
| finishing-a-development-branch | 决定合并、发 PR 还是留着分支 |
| writing-skills | 新建或改技能 |

工具映射（Bash 到 pwsh、Read/Write 到 fs 等）在 skills/using-superpowers/references/dsh-tools.md。

同名技能谁生效

官方注册表在同层重名时按 rank 从小到大裁决。本包 rank 是 10，比 dsh-skill-filesystem 的项目级和用户级（100–500）以及官方内置 bundled（600）都小，所以只要有同名技能，本包这份生效，不会有两套规则打架。

技能开关与语言偏好

插件管理页里点开 @wenaixi/dsh-superpower 卡片，详情页底部就是开关面板。每个技能一个开关，关掉即两侧同时不可见：

- 模型不再在可用技能目录里看到它，skill 工具调用也会被拒；
- 你也没法再从斜杠命令补全或命令行技能清单里调它。

面板上方还有全部开启、全部关闭、恢复默认三个批量操作和一个搜索框。

- 拨动后立即生效，模型的下一轮对话就能看到新目录；当前这一轮不受影响。
- 状态写在 profile 的 cordis.patch.yml 的 disabled 与 language 字段中，跟着 profile 一起备份迁移，重装插件不丢。
- 只影响本包这 15 个技能，不碰官方和第三方插件提供的技能。
- 语言切换：面板顶部（说明文案之下）提供「中文 / English / 跟随宿主（自动）」三段式选择器，一次切换全部 15 个技能描述（英文 description 与中文 description_zh）的显示语言，即模型目录与斜杠唤出技能栏里看到的描述文本；技能名与正文都不变。控件只影响 Superpower Skill: 后面的文本：面板其余 UI（标题、批量按钮、搜索框、提示）跟随宿主界面语言，技能正文恒为英文原版。两种描述分别以 Superpower Skill: / Superpower Skill： 开头。未配置时描述动态跟随宿主界面语言（设置里选的语言），并显示提示；显式选择中文或 English 后锁定，选择「跟随宿主（自动）」即可随时清除锁定、恢复跟随宿主。偏好保存在 profile 的 language 字段中（跟随宿主时自动 unset）。

使用

「帮我做 XXX」 → brainstorming → writing-plans → subagent-driven-development 「修这个缺陷」 → systematic-debugging 「帮我评审」 → requesting-code-review 「刚才会话出问题了」 → diagnosing-superpowers

校验：await ctx.skills.list({cwd}) 应该返回 15 条 provider: superpowers。

开发

pnpm install && pnpm build && pnpm typecheck && node scripts/verify.mjs

同名优先实测一：自研桩对照，无外部依赖，任何环境可跑
node scripts/check-same-name-priority.mjs

同名优先实测二：加载官方 @deepseek-ai/dsh-skill-filesystem 做同层实测该包不在 profile 的直接依赖里，脚本会依次尝试 profile 入口、pnpm store 内 .pnpm 真实目录、全局 dsh 本体三处候选路径。
本机没装 dsh（比如纯 CI）就用上面的自研桩脚本做等价验证。
node scripts/check-same-name-priority-fs.mjs

技能开关端到端实测：真实 SkillRegistry 上验证默认全开、禁言生效、热失效闭环
node scripts/check-skill-switches.mjs

上游同步全量复核（deep + tokens 双绿）
node scripts/review-sync.mjs

dsh --profile web --dump-config # 断言 "# == @wenaixi/dsh-superpower"

浏览器端验证

可选，需要本机装好 dsh 和 Python 的 playwright。两个脚本只做验证，地址和路径都从命令行传：

| 脚本 | 验什么 |
| scripts/browser/verify-switch-ui.py | 真机 Web UI 里点开插件卡片，逐个拨开关、点批量按钮、搜索过滤，再回读 cordis.patch.yml 确认落盘 |
| scripts/browser/verify-model-perception.py | 四阶段闭环：UI 写完用宿主真实 SkillRegistry 复核两侧可见性，并逐行比对 UI 显示与宿主目录 |

1. 起一个装了本插件的 profile 的 Web 服务，记下启动日志里的 token
dsh --profile <profile> --no-open --port 3199

2. 面板全量操作
python scripts/browser/verify-switch-ui.py \
http://127.0.0.1:3199 <token> .verify-shots <profile>/cordis.patch.yml .verify-shots/expected.json

3. UI 与宿主的四阶段闭环
python scripts/browser/verify-model-perception.py \
http://127.0.0.1:3199 <token> <profile 目录> <profile>/cordis.patch.yml .verify-shots

expected.json 是 15 个技能名的数组，用来断言 UI 行序和 skills/ 目录一致：

node -e "import('./lib/superpowers.js').then(async m=>{const c=await m.SkillCatalog.fromDirectory('skills');require('fs').writeFileSync('expected.json',JSON.stringify(c.verifyIntegrity().entries.map(e=>e.document.name)))})"

截图落在 .verify-shots/，已在 .gitignore 里。

目录

src/superpowers.ts # 插件入口，SkillProvider rank 10 src/catalog.ts # SkillCatalog：技能编目、三键聚合指纹探测、快照复用、规范自检 src/document.ts # SkillDocument：frontmatter 解析、契约转换、内建 selfTest src/switches.ts # 技能开关：禁言表解包与 invocation 覆盖，内建 selfTest src/client.js # 浏览器半侧：插件卡片详情页的单开关面板，手写 CJS factory skills/ # 15 个技能正文与资源 lib/ # 已提交的构建产物，GitHub 直装免构建 locale/ # 插件卡片的标题与描述（中英）；面板 UI 经官方 locale 注册表双语切换 icon.png # 插件卡片、README 顶部、GitHub 头像共用 scripts/ # 门禁、同名裁决实测、开关实测、上游同步复核、浏览器验证 scripts/build-client.mjs # 复制客户端产物后校验内联清单与 skills/ 目录一致 scripts/lib/contract.mjs # 技能内容契约治理，规则全内聚在这一处 scripts/lib/sync-engine.mjs # 上游同步引擎，返回结构化 diagnostics scripts/lib/harness-common.mjs # 两个同名裁决实测脚本的公共骨架 scripts/lib/client-manifest.mjs # 内联清单与 skills/ 的漂移判定 scripts/lib/sync-common.mjs # 同步复核共享原语：归一化、代码块切分、目录遍历

更新日志

版本沿革与逐版变更记录在 CHANGELOG.md，新版本在前，每个版本一段。

常见问题

装完 404 或者版本不对？ 换 GitHub 形式安装，或者加 --registry https://registry.npmjs.org 走官方源。不需要配置白名单。查最新版本用 npm view @wenaixi/dsh-superpower --registry https://registry.npmjs.org。

卡片标题、描述或图标是空的？ 根因通常是 package.json 的 exports 没放行 ./package.json 和 ./locale/.json，或者 icon 指向了包外的绝对路径。node scripts/verify.mjs 会把这两类问题连同 files 是否放行图标一起断言掉。

协议

MIT，详见 LICENSE。

贡献

Issue 和 PR 都欢迎。详见 CONTRIBUTING.md。

致谢

- 上游 obra/superpowers
- DeepSeek Harness 的三角色插件架构
- dsh-plugin-dev 提供的 DSH 插件开发规范、架构参考与真机验收工程方法