Skip to content
Back to search

superpowers-dsh

Superpowers skills for DeepSeek Harness: TDD, debugging, planning, and collaboration skills adapted from obra/superpowers

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/laynechai--superpowers-dsh/badge.svg)](/listings/laynechai--superpowers-dsh)

HTML

<a href="/listings/laynechai--superpowers-dsh"><img src="/api/listings/laynechai--superpowers-dsh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 430 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. [English](README.en.md) | **简体中文**
  3. </div>
  4. <div align="center">
  5. ![superpowers-dsh](static/home.png)
  6. </div>
  7. # superpowers-dsh
  8. 为 **DeepSeek Harness (DSH)** 打造的 Superpowers 插件包:把
  9. [obra/superpowers](https://github.com/obra/superpowers) 的核心技能
  10. (Claude-Code 技能库:TDD、调试、规划、协作模式)移植到 DSH 的 Cordis
  11. 插件架构上。
  12. 插件会向 `ctx.skills` 注册表的 **host 层** 注册一个技能提供者,因此每个
  13. agent preset 的作用域链都会合并这些技能。技能正文随包分发
  14. (`skills/<name>/SKILL.md`),通过 `import.meta.url` 定位——这是包的
  15. 组装事实,不需要任何用户配置。
  16. ## 目录
  17. - [在 DeepSeek Harness 中安装与使用](#在-deepseek-harness-中安装与使用)
  18. - [DSH 版本兼容性](#dsh-版本兼容性)
  19. - [技能列表](#技能列表)
  20. - [工作原理](#工作原理)
  21. - [上游同步](#上游同步)
  22. - [移植说明](#移植说明)
  23. - [添加自己的技能](#添加自己的技能)
  24. - [许可证](#许可证)
  25. ## 在 DeepSeek Harness 中安装与使用
  26. 这是 DeepSeek Harness 的**插件包**。安装后会把下面的 15 个技能注册进
  27. host 技能注册表,你 profile 里的每个 agent 会话都能在技能目录中看到它们,
  28. 并可用 `skill` 工具加载。技能内容同步自上游 **obra/superpowers v7.0.2**。
  29. ### 最简单:一条命令
  30. 不需要先全局安装 `dsh`,在任意目录执行:
  31. ```sh
  32. npx @deepseek-ai/dsh plugin --profile web add github:LayneChai/superpowers-dsh
  33. ```
  34. 装完后重启 `npx @deepseek-ai/dsh web`(或 `dsh web`),刷新浏览器即可。
  35. ### 最推荐:直接让 DeepSeek Harness 帮你安装
  36. 打开 DeepSeek Harness(Web 界面),新建对话,把下面这句话发给它:
  37. ```
  38. 帮我安装这个链接里边的插件:https://github.com/LayneChai/superpowers-dsh
  39. ```
  40. Agent 会自动完成安装(`dsh plugin --profile web add` → 重启 profile →
  41. 验证技能注册),无需你手动敲任何命令。装完后你可以在对话里让它运行
  42. `dsh --profile web --dump-config`,确认输出里有 `superpowers-dsh` 行。
  43. ### 从 npm 安装(推荐,一条命令)
  44. 包已发布到 npm,名为 `superpowers-dsh`(国内会自动同步到 npmmirror 镜像):
  45. ```sh
  46. dsh plugin --profile web add superpowers-dsh
  47. ```
  48. > 必须用 `dsh plugin` 形式——直接 `npm install superpowers-dsh` 只会把包当
  49. > 普通库装到当前目录,**不会**注册进任何 DeepSeek Harness profile,技能
  50. > 永远不会被加载。
  51. ### 从 GitHub 安装
  52. ```sh
  53. # 任意目录下执行
  54. dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.git
  55. ```
  56. ### 从 tarball 或本地文件夹安装
  57. ```sh
  58. # tarball(例如 Release 里的 superpowers-dsh-0.1.0.tgz)
  59. dsh plugin --profile web add C:\路径\to\superpowers-dsh-0.1.0.tgz
  60. # 或解压后的插件文件夹(pnpm 以链接方式安装,改完重启即生效)
  61. dsh plugin --profile web add C:\路径\to\superpowers-dsh
  62. ```
  63. ### 重启并验证
  64. bundle 层在 profile 启动时挂载,所以需要**重启 profile**(停掉后重新运行
  65. `dsh web` / `npx @deepseek-ai/dsh web`,再刷新浏览器)。确认层已组合:
  66. ```sh
  67. dsh --profile web --dump-config # 必须出现 `superpowers-dsh` 行
  68. ```
  69. 之后技能会出现在 agent 技能目录中(`using-superpowers` 是入口技能),
  70. 可以用 `skill` 工具加载。
  71. 安装成功后的界面如下:
  72. ![安装成功截图](static/install-success.png)
  73. ### 在其他 profile(headless / tui / 自定义)中使用
  74. 把 `--profile` 指向你实际运行的 profile:
  75. ```sh
  76. dsh plugin --profile headless add superpowers-dsh
  77. dsh --profile headless --dump-config
  78. ```
  79. ### 卸载
  80. ```sh
  81. dsh plugin --profile web remove superpowers-dsh
  82. # 卸载后同样需要重启 profile
  83. ```
  84. ### 注意事项
  85. - 国内用户可以先把 npm 镜像设为 npmmirror,让 `dsh plugin add
  86. superpowers-dsh` 更快:`npm config set registry https://registry.npmmirror.com`
  87. - 从文件夹或 `file:` 规格安装的插件是链接安装(不是复制):修改该文件夹后,
  88. 下次重启 profile 生效
  89. - 使用者**不需要 npm 账号,也不需要 2FA**——安装只是普通的包下载
  90. ## DSH 版本兼容性
  91. **结论:与 npm 上已发布的全部 DSH 版本兼容;已在 DSH `0.2.0-rc.2`(当前 `latest`)上端到端实跑验证。无已知不兼容问题。**
  92. 核对日期 2026-10-03,npm 发布通道:`latest` = `next` = `0.2.0-rc.2`,`alpha` = `0.2.1-alpha.1`。
  93. ### 支持矩阵
  94. | 检查项 | 结果 |
  95. | --- | --- |
  96. | 插件依赖的 DSH 接口 | ① `ctx.skills.registerProvider(...)`(技能提供者注册)② `dsh.bundle.patch`(bundle 挂载自己的 `cordis.patch.yml`) |
  97. | 已发布版本数 | 承载接口的两个包 `@deepseek-ai/dsh-skill` 与 `@deepseek-ai/dsh-app-boot` 各 **31 个已发布版本** |
  98. | 逐版本核对结果 | **31 / 31 全部一致**,从最早的 `0.0.1-rc.1` 到最新的 `0.2.1-alpha.1`,接口签名与语义均未变 |
  99. | 端到端实跑 | 把 `lib/index.js` 挂进本机 DSH `0.2.0-rc.2` 的**真实 `SkillRegistry`**:`list()` 返回 15 个技能,逐个 `get()` 都能取到正文与 `resourceBase` |
  100. | 插件自身版本 | `0.5.0`(技能内容同步自 obra/superpowers `v7.0.2`) |
  101. | 运行时依赖 | 无。只用 Node 内置模块,不引入任何第三方依赖,因此不受 DSH 依赖树变化影响 |
  102. | Node.js | 本机验证 `v22.22.2`;DSH 自身未声明 `engines`,本插件也未限制 |
  103. ### 已知兼容性说明
  104. - **无已知不兼容问题。** 上游 DSH 从 `0.1.7-rc.2` 起加入插件兼容性闸门
  105. `evaluatePluginCompatibility`:它**只检查插件自己声明的 `@deepseek-ai/dsh*`
  106. peerDependencies**,范围不满足就把整个 bundle 跳过并报错。本插件不声明任何
  107. peerDependencies,因此这道闸门**不会拦截它**(同时它也意味着 DSH 不会替你校验版本,
  108. 所以升级 DSH 后建议跑一次下面的复核命令)。
  109. - **同名技能的优先级是有意选择**:插件以 `PACKAGED_SKILL_RANK = 550` 注册,DSH 内置
  110. bundled 根为 `BUNDLED_SKILL_RANK = 600`(数值越小越优先),所以**同名时你自己的技能
  111. 会覆盖本插件的同名技能**。DSH 内置技能里没有与本插件重名的技能。
  112. - **Windows 提示**:技能正文里的 bash 辅助脚本需要 Git for Windows(Git Bash);Node
  113. 脚本(`server.cjs`、`render-graphs.js`)全平台可用。技能正文已按"经解释器调用"
  114. (`bash scripts/...`)编写,不依赖 Unix 可执行位。
  115. - 安装方式不影响兼容性:npm 包、GitHub 源、本地目录链接三种安装方式加载的是同一份
  116. bundle 声明。
  117. ### 兼容性怎么复核
  118. 一条命令,对着**你本机安装的** DSH 复跑上面全部检查(包括真实注册表挂载):
  119. ```sh
  120. node scripts/check-dsh-compat.mjs
  121. # 也可指定别的 node_modules,或用 $DSH_NODE_MODULES
  122. node scripts/check-dsh-compat.mjs D:\path\to\profile\node_modules
  123. ```
  124. 本机实测输出:
  125. ```
  126. dsh SDK : @deepseek-ai/dsh-skill 0.2.0-rc.2
  127. mounted : 15 skills listed and read through the real SkillRegistry
  128. rank : PACKAGED_SKILL_RANK=550 is below BUNDLED_SKILL_RANK=600
  129. check-dsh-compat: OK — this plugin matches the installed DSH SDK
  130. ```
  131. 它依次检查:SDK 是否存在及版本 → 已安装 SDK 的类型声明里是否仍声明本插件实现的接口
  132. (`registerProvider`、`SkillProvider.list/get`、`SkillCandidate`、`SkillResourceBase`、
  133. `'custom'` 来源桶)→ 把 `lib/index.js` 真的挂进 `SkillRegistry` 并逐个读回 →
  134. 比较 rank 关系。任一项不成立就 `exit 1`,并指出具体是哪条契约变了。
  135. 在**没有安装 DSH 的机器**上(例如 CI、干净容器)没有可比对的对象,它会打印
  136. `SKIPPED` 并 `exit 0`——这是"没检查",不是"检查失败"(发布流程因此不会被误拦)。
  137. 显式传目录或以 `--require` 运行时,找不到 SDK 仍按错误处理。想强制要求先装 SDK:
  138. `DSH_COMPAT_REQUIRE=1 node scripts/check-dsh-compat.mjs`。
  139. > 结论以**验证时的 DSH 版本**为准。如果你跑的是更新的 DSH,先跑一遍上面的命令;
  140. > 上游一旦改动技能接口,它会立刻报出具体变化,而不是等到技能悄悄消失。
  141. ## 技能列表
  142. | 技能 | 用途 |
  143. | --- | --- |
  144. | `using-superpowers` | 如何查找和使用技能;入口技能 |
  145. | `brainstorming` | 动手前先问清「你到底想要什么、为什么」,理解后再定规模和做法 |
  146. | `writing-plans` | 根据规格编写全面的实施计划 |
  147. | `executing-plans` | 本会话内(Native/内联)执行计划,末尾一次整分支评审 |
  148. | `subagent-driven-development` | 每个任务派发全新子代理并评审 |
  149. | `dispatching-parallel-agents` | 把独立工作扇出到并行代理 |
  150. | `systematic-debugging` | 先找根因的调试纪律 |
  151. | `test-driven-development` | RED-GREEN-REFACTOR 实施循环 |
  152. | `verification-before-completion` | 声称成功前先拿出证据 |
  153. | `requesting-code-review` | 合并前获得严格评审 |
  154. | `receiving-code-review` | 核实反馈,而不是盲目照做 |
  155. | `finishing-a-development-branch` | 安全地整合已完成的工作 |
  156. | `using-git-worktrees` | 功能开发的隔离工作区 |
  157. | `writing-skills` | 以 TDD 方式编写并验证新技能 |
  158. | `diagnosing-superpowers` | 会话出问题时读磁盘上的 transcript,带 `path:line` 取证复盘 |
  159. ## 工作原理
  160. - **Bundle 层** —— `cordis.patch.yml` 在 dsh-base 层之上插入一行
  161. (`- id: superpowers-dsh, name: superpowers-dsh`)。后面的层(profile 的
  162. `cordis.patch.yml`、`--patch` 叠加)仍可按 id 定位这一行。
  163. - **提供者** —— `lib/index.js` 调用 `ctx.skills.registerProvider(...)`,
  164. 注册一个提供者:
  165. - `list()` 扫描包内 `skills/` 目录,把每个 `<name>/SKILL.md` 作为候选,
  166. 从 YAML frontmatter 解析出 `name`、`description`、`whenToUse`。
  167. - `get()` 按需读取候选技能正文,返回完整技能定义,`resourceBase` 指向
  168. 技能所在目录,使相对引用(脚本、提示模板)可以正确解析。
  169. - **零运行时依赖** —— 插件只使用 Node 内置模块,消费注入的 `ctx.skills`
  170. 服务接口。
  171. ## 上游同步
  172. 当前同步的上游版本:**obra/superpowers v7.0.2**(见 `package.json` 的
  173. `dsh.superpowersUpstream`)。
  174. `skills/` 是**生成产物**,不要手改。同步逻辑写在两个地方,改它们再重跑即可:
  175. - `scripts/sync-from-upstream.mjs` —— 拉上游技能树 + 重放所有 DSH 适配
  176. (每条适配都是一个带断言的字符串改写,上游一旦改了原文就**直接报错**,
  177. 不会静默丢适配)。
  178. - `port/overrides/` —— 只属于 DSH 的文件(`using-superpowers/references/dsh-tools.md`),
  179. 覆盖到同步结果上。
  180. ```sh
  181. # 1. 取上游对应版本的源码(git 协议在部分网络不可用,走 codeload)
  182. mkdir -p .upstream/superpowers
  183. curl -L https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v7.0.2 \
  184. | tar -xz -C .upstream/superpowers --strip-components=1
  185. # 2. 重放同步
  186. node scripts/sync-from-upstream.mjs .upstream/superpowers
  187. # 3. 校验(provider 能列出全部技能、frontmatter 合法、没有悬空引用)
  188. node scripts/verify-skills.mjs
  189. # 4. 兼容性(对着本机安装的 DSH 真实 SDK 复跑契约与挂载检查)
  190. node scripts/check-dsh-compat.mjs
  191. ```
  192. 本次同步带来的上游变更(**v7.0.2**,2026-11-03;技能数仍为 15 个,文件 78 → 74):
  193. - **`brainstorming` 第三次调音——问得更少**(#2644):现在的规则是「**只有当答案
  194. 会改变要做什么、而现有信息又答不了时**才提问」;否则直接把它自己的判断作为
  195. 「可纠正的提议」讲出来。它也不再问你流程问题(怎么写文档、文件放哪、要不要再看
  196. 点别的、怎么给你看),这些它自己定并告诉你结果。
  197. - **没说你为什么想要,它就第一个问这个**:开放问法,不给可选项。
  198. - **有明确取舍时给选项+推荐**:某个测试场景里 spec 把 Ctrl+K 给了两个功能,
  199. v7.0.1 每次都发现了冲突,但 8/8 次只问了句「要哪个?」;v7.0.2 在 8/8 次里都
  200. 把选项摆出来并推荐一个。
  201. - **从你的说话方式判断你想不想聊技术选型**;请求本身没有留下开放问题时,它的
  202. 第一条消息就是一份简短设计供你批准。
  203. - 上游盲测数据:无意义提问从 v7.0.1 的 41 个降到 23 个;「理由先于方案」在 33/33
  204. 次对话中成立(改前 28/33);批准前不动手也做到了(改前有 4 次违规)。
  205. - **`start-server.sh --project-dir .` 修好了**(#2524 / #2608):脚本会先 `cd` 进
  206. 自己目录再启动服务,导致所有从相对 `--project-dir` 推导出的路径都指错、服务根本
  207. 起不来。现在先把该目录解析成绝对路径。
  208. - **SDD / executing-plans 的五个辅助脚本大改——这是本版对 DSH 影响最大的部分**
  209. (#2429 / #2242 / #1799 / #2606 / #2525 / #2607):
  210. - 新增 **`scripts/sdd-repo`**(54 行):像 `git` 一样,**以当前目录所在仓库为准**,
  211. 并支持 `-C DIR` 指定别的仓库。以前在仓库外跑 `sdd-workspace` 会把 workspace
  212. 写进 agent 当时所在的任意目录(经常是插件缓存目录)。
  213. - 五个 helper 现在**不在仓库里就 `exit 2` 并说明该怎么办**;全新项目要先
  214. `git init` 并做首次提交才能开工。
  215. - **技能正文改为「按绝对路径、从你正在执行的工作树调用 helper」**(以前说
  216. 「从本技能目录」,agent 一 `cd` 过去就把 helper 跑在插件自己的文件上了)。
  217. 上游还加了测试:技能里用相对路径指 helper 就失败。
  218. - **`task-brief` 认得 `A1`、`6b`、`2.1` 这类任务 ID**(以前凡字母开头一律拒绝,
  219. 而且取 Task 6 会把 Task 6b 一起带上);计划的标题不用英文时,它会明确要求
  220. 用「Task」这个词并列出它找到的标题。
  221. - **`task-brief` 拒绝被未闭合代码块吞掉的 brief**:漏一个结束围栏会隐藏后面
  222. 所有任务标题,有人的 177 行任务因此变成含五个任务的 1,159 行 brief。
  223. - **Windows 上 helper 打印 PowerShell 能直接打开的路径**(`C:/Users/…` 而不是
  224. `/c/Users/…`,经 `cygpath -m`)。
  225. - **`systematic-debugging` 不再自带测试场景**(#2277 / #2654):`CREATION-LOG.md`
  226. 和四个「这是一个真实场景,你必须选择并行动」的压力测试提示词原本装在 `SKILL.md`
  227. 旁边,agent 干活干到一半可能翻到它们。现在移到 `tests/` 下,并加了测试防止这
  228. 类文件再混进任何技能目录。**本 port 因此少了这 5 个文件。**
  229. - **与 DSH 无关的部分**:hooks(Copilot on Windows / Git Bash 子进程 / zsh 回退)、
  230. Pi / Hermes / OpenCode / Muse 的 bootstrap 修复都在 `skills/` 之外,DSH 也没有
  231. hook 系统。
  232. > **给 DSH 的适配**:v7.0.2 把 helper 的调用语义整个换了(当前目录的仓库、绝对
  233. > 路径、`-C DIR`),这在 DSH 上尤其要紧 —— 插件的技能装在插件安装目录里,不在你
  234. > 的项目里,`cd` 进插件目录再跑 helper 正是上游这次要堵的坑。`dsh-tools.md` 补了
  235. > 这一节:从技能自己的目录(`skill` 工具返回的 `resourceBase`)拼出绝对路径、
  236. > 用项目当工作目录或传 `-C`、空仓库要先 `git init`;并说明 Windows 上 `bash`
  237. > 指的是 Git for Windows。另外把 executing-plans 正文里 4 处 helper 调用统一加
  238. > `bash` 前缀(Windows 没有 Unix 可执行位),锚点也收窄成只匹配反引号内的命令本身
  239. > —— 上游每版都在改这段措辞,绑正文会一版一断。
  240. 上一版(**v7.0.1**,2026-10-21)的上游变更,保留备查:
  241. - **`brainstorming` 按反馈重新调音**(#2560 / #2571):v7.0.0 那套「开场先问
  242. 要不要跳过提问,再问一个泛泛的『你什么时候最想要它』」被用户吐槽像模板,
  243. v7.0.1 改掉了两件事 —— ①**先摸上下文再开口**:有项目、有 spec/plan/文件时,
  244. 第一句话之前先读它们,已经写在里面的不再问;②**问题接着你的答案走**:你说清
  245. 需求后,它先把你说的话连同项目里查到的东西**复述**一遍,只问那一个还没定的
  246. 点,后面的问题建立在你的回答和它的发现之上,并说明「这个答案会改变什么」。
  247. 「要不要跳过提问」现在**只在你没点名要 brainstorming 时才提供**;显式点名或
  248. `/brainstorming` 调用时不再多问一遍。
  249. - **设计文档不再被跳过**:明确要求「先说两三种做法+推荐一种让你挑,然后写设计
  250. 文档,你批准之前不动手」。上游实测:改之前 24/24 次跳过文档直接开工,改之后
  251. 3/24。
  252. - **三个长技能为「压缩后仍可存活」而拆分**(#2563 / #2564 / #2565,起因 #2481):
  253. Claude Code 在压缩后会把每个技能在 **20,000 字符处截断**,超出的部分整个会话
  254. 都不再存在 —— 有会话里 `subagent-driven-development` 因此丢了「最多 5 轮修复」
  255. 的限制,在一个任务上跑了 18 轮。
  256. - `subagent-driven-development`:把修复循环、最终评审、报告处理、续跑、
  257. preflight、分批、无法验证等内容移到 **`references/`**(7 个新文件),用到哪
  258. 一步再读哪个文件。**SKILL.md 32,510 → 19,470 字节。**
  259. - `writing-skills`:把支撑文档、SKILL.md 模板与发现机制、bulletproofing、
  260. flowchart 约定移到 `references/`(新增 `discovery.md`、`bulletproofing.md`、
  261. `flowcharts.md`,其余是原文件重命名进 `references/`)。
  262. **26,615 → 16,754 字节。**
  263. - `executing-plans`:删掉与上文规则重复的 Example Workflow。
  264. **20,454 → 18,164 字节。**
  265. - 上游同时加了 `tests/skill-size/test-skill-size.sh`,任何 `SKILL.md` 达到
  266. 20,000 字节即失败。本 port 现在 15 个 SKILL.md **全部低于 20,000 字节**
  267. (最大的是 `subagent-driven-development`,v7.0.2 后 19,704)。
  268. - **与 DSH 无关的部分**:issue / PR 模板改为要求「谁提的、你的人类伙伴原本要什么、
  269. 200 字以内由人写的摘要」(#2569),`diagnosing-superpowers` 跟着加这两节并改用
  270. Bug Report 模板,`docs/superpowers/plans/` 下 18 份历史计划文档被删除。这些都在
  271. `skills/` 之外,不进本 port 的产物。
  272. > **给 DSH 的适配**:v7.0.1 把 `writing-skills/references/CLAUDE_MD_TESTING.md`
  273. > 重命名进了 `references/`,这个文件也随之进入发布产物。它整篇是拿来测「技能文档
  274. > 怎么写才容易被发现」的场景稿,里面 14 处让 agent 去 `~/.claude/skills/` 找技能 ——
  275. > 在 DSH 上那个目录不存在,场景就测不出东西。同步脚本因此新增一条 `sweep` 改写,
  276. > 把它统一换成 `$DSH_HOME/skills/`。
  277. 上一版(**v7.0.0**,2026-10-10)的上游变更,保留备查:
  278. - **`brainstorming` 完全重写**(#2463 / #2482 / #2483):先在第一条消息里说明
  279. 「可以跳过提问直接开工」,然后问一个开放式问题让你描述真实场景;边聊边把
  280. 理解**分块复述**回来(约 200–300 字)让你纠正;理解清楚后再用大白话
  281. **定规模**(直接做 / 聊两句就动手 / 写设计文档),你可以否决;会主动确认
  282. 哪些「怎么做」的选择你想自己拿主意(平台、语言、库、媒介),你交出去它就
  283. 选合理默认值并说明。
  284. - **设计文档的评审换成 builder check**:**新增**
  285. `skills/brainstorming/builder-check-prompt.md`,派一个全新子代理以「要动手
  286. 建它的人」的视角读设计、列出还需要问什么;**删除**
  287. `skills/brainstorming/spec-document-reviewer-prompt.md`(旧 spec reviewer 被
  288. 取代)。问出来的问题只回一轮。
  289. - **`subagent-driven-development` 的 `scripts/sdd-workspace`**:不再每次覆盖
  290. 仓库自己的 `.superpowers/sdd/.gitignore`(只在文件不存在时写默认值);
  291. Windows/Git Bash 下计划标记保持**仓库相对路径**(原先会记成机器绝对路径)。
  292. - **`executing-plans` 的 `scripts/task-done`**:测试命令**静默通过**(无输出)
  293. 时现在也写 ledger,记为 `→ (no output)`;以前 `grep|tail` 返回非零会 exit 1,
  294. 让已完成的任务看起来没完成。
  295. - **`requesting-code-review`**:示例里的 base-SHA 命令改用 `cut -d' ' -f1`,
  296. 因为 Claude Code 会把技能正文里的 `$1` 替换成调用参数。
  297. - **`systematic-debugging`**:多层诊断示例不再把要检查的密钥**值**打进日志。
  298. - **视觉伴侣 `scripts/server.cjs`**:修掉 `String.replace` 把 `$'`、`$&` 当
  299. 替换模式的问题,现在按字面量插入内容。
  300. - 其余为 Antigravity / Hermes / Claude Code hooks 相关修复,DSH 没有 hook
  301. 系统,不适用本 port。
  302. ## 移植说明
  303. - 去掉了命名空间前缀:`superpowers:brainstorming` → `brainstorming`
  304. (DSH 技能用裸名称寻址)。
  305. - `using-superpowers` 现在介绍 DSH 的 `skill` 工具,并指向
  306. `skills/using-superpowers/references/dsh-tools.md`——完整的
  307. Claude-Code → DSH 工具映射(`pwsh`、`subagent`、`workflow`、`goal` ...)。
  308. 上游那份“按 harness 选参考文件”的清单(Claude Code / Codex / Gemini /
  309. Copilot / Pi / Antigravity / Hermes / Muse)只保留 DSH 一份,其余上游
  310. `references/*-tools.md` 不随包分发。
  311. - 子代理引用映射到 DSH 的 `subagent` / `subagent_fork`;上游的命名 agent
  312. (`superpowers:code-reviewer`)在 DSH 不存在,按技能自带的 prompt 模板派发。
  313. - `using-superpowers` 里的 `<SUBAGENT-STOP>` 不再保留:DSH 的子代理同样需要
  314. 遵守技能(实现者子代理必须走 TDD)。
  315. - 跨 harness 的路径改成 DSH 路径:`~/.claude/skills/` → `$DSH_HOME/skills/`,
  316. `~/.superpowers/...` → `$DSH_HOME/...`(默认 `~/.dsh`)。
  317. - `diagnosing-superpowers` 补了 DSH 的会话存储事实
  318. (`$DSH_HOME/sessions/<cwd-slug>/session-<uuid>/session.*.jsonl.zstd`,
  319. 多 zstd frame 拼接,需按 frame 解压)。
  320. - `brainstorming` 的视觉伴侣补充了 Windows 说明:Node 服务
  321. (`scripts/server.cjs`)全平台可跑;`.sh` 辅助脚本仅限 bash。
  322. - `brainstorming` 在 v7.0.0 重写后,上游正文已直接写 `visual-companion.md`
  323. 这个裸相对名,所以本 port 原先那条「把 `skills/brainstorming/...` 改写成
  324. 裸相对名」的适配已删除(同步脚本里留有 NOTE,若上游将来回退再加回)。
  325. - `writing-skills/references/CLAUDE_MD_TESTING.md` 随 v7.0.1 的重命名进入发布
  326. 产物(原先在 `examples/` 下,上游一直没把它当正文看)。它整篇是「技能文档
  327. 怎么写才容易被 agent 发现」的测试场景稿,所以保留;但里面 14 处让 agent 去
  328. `~/.claude/skills/` 找技能,在 DSH 上那个目录不存在、场景就测不出东西,
  329. 因此同步脚本用一条 `sweep` 改写统一换成 `$DSH_HOME/skills/`。同一文件里
  330. `~/.claude/CLAUDE.md` 这类**历史出处**描述不改(那是事实记录,不是指令)。
  331. ## 添加自己的技能
  332. `list()` 会自动发现包里任何 `skills/<kebab-name>/SKILL.md`——只要它以 YAML
  333. frontmatter 开头(`name` + `description`,可选 `whenToUse`),无需改代码。
  334. 注意:`skills/` 是上游同步的生成目录,**重跑 `scripts/sync-from-upstream.mjs`
  335. 会整体重建它**,直接放进去的自建技能会被删掉。两个安全位置:
  336. - 放到 `$DSH_HOME/skills/`(用户级)或项目的 `.dsh/skills/` —— 与插件无关,
  337. 最省事;
  338. - 或者放进 `port/overrides/<kebab-name>/SKILL.md` —— 同步时会被复制进
  339. `skills/`,因此不会被清掉。
  340. ## 许可证
  341. MIT。技能内容改编自
  342. [obra/superpowers](https://github.com/obra/superpowers)(MIT),© Jesse Vincent
  343. 及贡献者。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.