在 DSH 中直接让模型进入编码阶段,往往缺乏结构化的前置步骤,容易导致调试困难或需求遗漏。dsh-superpowers 移植了 obra/superpowers 的技能框架,为 DSH 引入了 14 个预定义的软件开发技能和会话启动引导。这套框架强制模型在动手之前先进行头脑风暴、制定计划,并在开发、测试、调试和评审环节遵循既定流程。
这是一个由 TangYT 维护的 DSH 插件,采用 MIT 许可证。它将上游的技能文件与 DSH 原生工具映射结合,通过会话启动时的系统提示注入,让模型能够自动调用这些技能。
核心功能¶
该插件主要包含以下能力:
- 14 个开箱即用技能:覆盖从需求分析到代码合并的全流程。
- 会话启动引导:在每次新会话开始时,系统提示中会自动注入技能使用规则,确保模型按规范工作。
- DSH 原生工具映射:将技能中的动作语言翻译为 DSH 的原生工具,例如
subagent(派发子代理)、todo_write(创建待办)、pwsh/bash(执行命令)等。 - 零依赖与热更新:基于 Node.js 内置模块实现,修改技能文件后无需重启,下次加载即时生效。
- 一键同步上游:提供脚本从 pin 定的上游版本重新拉取技能内容。
技能清单¶
插件内置的 14 个技能及其触发场景如下:
| 技能名称 | 触发场景 |
|---|---|
brainstorming |
任何创造性工作前,澄清意图、需求与设计 |
writing-plans |
有需求或规格时,动手写代码前制定实施计划 |
executing-plans |
在独立会话中执行书面实施计划,带评审检查点 |
subagent-driven-development |
每个任务派发全新实施子代理,并进行任务与全分支评审 |
test-driven-development |
实现功能或修 bug 前,强制执行红-绿-重构流程 |
systematic-debugging |
遇到 bug 或测试失败时,先进行根因分析再修复 |
requesting-code-review |
完成任务或合并前,请求评审验证 |
receiving-code-review |
收到评审意见后,如何核实与回应 |
using-git-worktrees |
需要隔离工作区时使用 git worktree |
dispatching-parallel-agents |
派发 2 个或更多无共享状态的独立任务并行执行 |
verification-before-completion |
声称完成任务前,必须运行验证命令获取证据 |
finishing-a-development-branch |
实现完成后,如何进行集成、合并或清理 |
writing-skills |
编写、修改或验证新技能本身(元技能) |
using-superpowers |
会话开始时如何发现与调用技能 |
安装与启用¶
安装该插件需要使用 DSH 的插件命令。
dsh plugin --profile <profile> add git+https://gitee.com/tang-yongtao/dsh-superpowers.git
安装完成后,必须重启 dsh web 进程才能使插件生效。重启后,新会话的系统提示中会出现 You have superpowers. 的引导段,技能目录中也应包含上述 14 个技能。
使用方式¶
技能的调用主要通过自然语言触发,无需记忆特定命令。
- 自然语言触发:直接在对话中提出需求。例如说“帮我头脑风暴一个新功能”,模型会自动调用
brainstorming技能;说“这个 bug 查下根因”,会调用systematic-debugging。 - 斜杠命令调用:在输入框输入
/,命令菜单中会列出所有技能(如/brainstorming)。选中或直接输入技能名发送,即可显式注入该技能。 - 列出技能:在对话中询问“你现在有哪些技能?”,模型会列出当前可用的技能列表。
- 跳过技能:用户拥有最高优先级。如果不想使用某个技能,可以直接说“不用头脑风暴,直接改”,模型将忽略该技能。
配置说明¶
在插件的配置中,可以控制是否在会话启动时注入引导信息。
编辑 profile 中该插件的行配置(bundle patch 的 config):
config:
bootstrap: false # 关闭会话启动注入(保留技能 provider)
开启 bootstrap 会导致系统提示每请求多出约 5-6KB 的前缀内容。如果介意 token 开销,可以选择关闭此项,但模型将不再自动检查是否有匹配技能。
注意事项¶
- 重启生效:安装后务必重启
dsh web,否则技能不会加载。 - Token 开销:开启 bootstrap 会增加每轮请求的系统提示长度。
- Web UI 依赖:
brainstorming技能包含一个可选的 Web UI(位于skills/brainstorming/scripts/),但其依赖的 bash 脚本在 Windows 上需要 WSL 或远程 Linux 环境。 - 版权归属:技能内容(正文)版权归 obra (Jesse Vincent) 所有,本仓库仅做移植层(bootstrap/provider/工具映射)与同步脚本。
总结¶
dsh-superpowers 通过引入标准化的 Agentic 技能和工作流,降低了在 DSH 中使用复杂软件工程方法的门槛。对于希望提升代码质量和开发流程规范性的用户,这套技能框架提供了从规划到合并的完整闭环支持。
项目目录:https://www.skillhub.cn/plugins/TangYT/dsh-superpowers
GitHub 仓库:https://github.com/TangYT/dsh-superpowers