前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。对于开发者而言,直接集成像 obra/superpowers 这样成熟的编码范式技能库(包含 TDD、系统化调试、头脑风暴、计划执行等技能)通常需要手动搬运文件。peijingbobo/dsh-superpowers-plugin 插件将 obra/superpowers 转化为一个零依赖的 ESM Bundle,使 AI 能够在 DSH 会话中自动识别并应用这些技能,无需手动干预。
核心功能¶
该插件基于零依赖 ESM JavaScript 构建,主要能力如下:
- 自动识别与应用:插件向 DSH 技能注册表 (
ctx.skills) 注册 provider,模型可按需调用skill({ name })获取技能指令。 - 会话技能目录注入:利用 DSH 内建机制,自动注入
<available_skills>持久提醒,列出全部技能摘要。 - 指令直呼:支持
/技能名格式,如输入/systematic-debugging会直接注入技能全文。 - 主动应用强化:在会话开始时注入一次
using-superpowers定向说明,引导模型检查并加载匹配技能。 - 上游跟踪与自动同步:内置轮询机制(每 6 小时一次),检测到上游 obra/superpowers 更新后自动构建新版本。
- 版本对齐:插件版本号与上游 superpowers 版本号保持一致。
安装与启用¶
前置条件为已安装 DeepSeek Harness CLI(源码运行则使用 pnpm dsh ...)。
执行以下命令安装:
dsh plugin add github:PeiJingbobo/dsh-superpowers-plugin
安装后启动 Harness:
dsh web
启动日志中应出现类似 dsh-superpowers-plugin: serving skills from .../skills 的提示,表示插件已生效。
使用方法¶
启用插件后,在 DSH 会话中可直接体验以下场景:
- 智能触发:输入“帮我实现 X 功能”,模型应自动识别意图并调用
skill加载brainstorming等相关技能。 - 指令注入:直接输入
/systematic-debugging,技能全文会直接注入当前会话。 - 引导提示:新会话开头会出现
You have superpowers.引导语,提示模型使用可用技能。
注意事项¶
- 技能优先级:项目目录同名技能优先于插件内置副本(rank 600)。这意味着你可以在本地覆盖特定技能,而不影响插件的整体更新。
- 许可证:插件代码为 MIT 许可证,技能内容来自 obra/superpowers(MIT)。
- 源码开发:若需源码开发,需使用
pnpm dsh web --patch /path/to/dsh-superpowers-plugin/cordis.local.example.yml。 - 权限与检查:插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证。
总结¶
dsh-superpowers-plugin 解决了技能库集成的繁琐问题,通过自动化同步机制确保技能库紧跟上游更新。开发者无需关心文件搬运,只需关注技能内容本身。更多详情可查阅插件目录或 GitHub 仓库。