dsh-superpowers:DeepSeek Harness Agentic 技能框架

在 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 个技能。

使用方式

技能的调用主要通过自然语言触发,无需记忆特定命令。

  1. 自然语言触发:直接在对话中提出需求。例如说“帮我头脑风暴一个新功能”,模型会自动调用 brainstorming 技能;说“这个 bug 查下根因”,会调用 systematic-debugging。
  2. 斜杠命令调用:在输入框输入 /,命令菜单中会列出所有技能(如 /brainstorming)。选中或直接输入技能名发送,即可显式注入该技能。
  3. 列出技能:在对话中询问“你现在有哪些技能?”,模型会列出当前可用的技能列表。
  4. 跳过技能:用户拥有最高优先级。如果不想使用某个技能,可以直接说“不用头脑风暴,直接改”,模型将忽略该技能。

配置说明

在插件的配置中,可以控制是否在会话启动时注入引导信息。

编辑 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜