超能力开发法 JasonFreeLab/dsh-superpowers

dsh-superpowers

obra/superpowers 的 DSH（DeepSeek Harness）移植版 —— 把完整的多智能体软件开发方法论以原生 DSH 技能形式开箱即用。

移植自上游 obra/superpowers（v6.4.2，作者 Jesse Vincent / Prime Radiant）。技能内容直接取自上游，并映射到 DSH 工具集。

目录

- 特性
- 安装
- 使用
- 包含技能
- 工具映射
- 目录结构
- 开发
- 贡献
- 协议

特性

- 15 个方法论技能 —— 头脑风暴 → 计划 → TDD → 系统化调试 → 代码评审 → 集成，另含会话诊断。
- 原生 DSH 技能 —— 通过 SkillProvider 注入 ctx.skills（rank 550，可被项目/用户技能覆盖）。
- 英文国际化 —— 技能内容保持英文原文；中文文档见 README.zh.md。
- 零构建安装 —— lib/ 已提交，GitHub 直装无需构建。
- 自动化发布 —— release-please（版本 + CHANGELOG + Release 说明）+ npm 与 GitHub Packages 可信发布。

安装

以主工作台 web 为例（其它 profile 改 --profile）。前置：Node >= 20、pnpm >= 9、dsh。

从 npm 安装（推荐）
dsh plugin --profile web add @jasonfreelab/dsh-superpowers

本地路径安装（开发/离线）
git clone https://github.com/JasonFreeLab/dsh-superpowers.git && cd dsh-superpowers
pnpm install && pnpm build
dsh plugin --profile web add ./

验证：应能看到 id: superpowers
dsh --profile web --dump-config | grep -A2 '@jasonfreelab/dsh-superpowers'

更新 / 卸载
dsh plugin --profile web add @jasonfreelab/dsh-superpowers
dsh plugin --profile web remove @jasonfreelab/dsh-superpowers

同时发布到 GitHub Packages（需鉴权）：npm.pkg.github.com/@jasonfreelab/dsh-superpowers。

使用

在 DSH web 界面

1. 启动 web 界面并打开打印出的地址：dsh web（即 dsh --profile web）。
2. 新建会话。15 个技能会自动注册到 ctx.skills，并出现在模型的 <available_skills> 目录里——无需额外配置。
3. 模型会通过 skill 工具自行加载匹配的技能。
4. 你也可以显式调用：输入 /技能名，例如 /superpower-brainstorming。

典型流程

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

校验：进入会话后 await ctx.skills.list({cwd}) 应有 15 条 provider: superpowers。

包含技能

| 技能 | 触发时机 |
| superpower-using-superpowers | 任意会话起点，先加载技能再回应 |
| superpower-brainstorming | 任何创造性工作之前（新功能/组件/改行为） |
| superpower-writing-plans | 有了规格/需求、动手写代码之前 |
| superpower-using-git-worktrees | 需要隔离工作区或执行计划之前 |
| superpower-executing-plans | 在当前会话中由你自己内联执行计划（人类伙伴选择了内联执行，或无子代理工具） |
| superpower-subagent-driven-development | 按计划逐任务派子代理执行 |
| superpower-dispatching-parallel-agents | 面对 2+ 个互不依赖的独立任务 |
| superpower-test-driven-development | 实现任何功能/修复之前（RED-GREEN-REFACTOR） |
| superpower-systematic-debugging | 遇到任何 bug/测试失败/异常行为，提出修复之前 |
| superpower-verification-before-completion | 宣称完成/已修复/通过之前，先跑验证拿证据 |
| superpower-requesting-code-review | 完成任务/大功能/合并前请求评审 |
| superpower-receiving-code-review | 收到评审反馈、动手实现建议之前 |
| superpower-finishing-a-development-branch | 实现完成、测试通过，决定如何集成 |
| superpower-writing-skills | 新建/编辑/验证技能之前 |
| superpower-diagnosing-superpowers | superpowers 会话出了问题（重复劳动、无视计划、频繁卡壳、技能未触发、成本异常）时，排查原因或生成给维护者的缺陷报告 |

工具映射

obra 原文引用的是 Claude Code 工具，本包已映射到 DSH 工具（详见 skills/superpower-using-superpowers/references/dsh-tools.md）：

| Claude Code | DSH |
| Bash | bash |
| Read / Write / Edit | read / write / edit |
| Glob / Grep | glob / grep |
| TodoWrite | todo_write |
| Task（子代理） | subagent / subagent_fork |
| ExitPlanMode | exit_plan_mode |
| AskUserQuestion | ask_user_question |
| WebFetch / WebSearch | web_fetch / web_search |
| 呈现交付物 | present |
| 读取图片 | read_image |
| 加载技能 | skill 工具 / /name 手势 |

目录结构

src/superpowers.ts # SkillProvider（rank 550），惰性加载 SKILL.md 正文 skills/ # 15 个技能（英文，含 references/） lib/ # 构建产物（已提交，GitHub 直装零构建） scripts/ # test.mjs + verify.mjs cordis.patch.yml # bundle patch .github/workflows/ # ci.yml + release.yml + release-please.yml

开发

pnpm install
npm run build # 或 pnpm build
npm run typecheck
npm test # 全面测试（内容卫生 + 真实 SkillRegistry）
npm run verify # 结构校验 + 运行时冒烟

贡献

欢迎提交 Issue / PR。上游方法论见 obra/superpowers。

协议

MIT，与上游 obra/superpowers 保持一致（Jesse Vincent / Prime Radiant）。