前言¶
DeepSeek Harness (DSH) 採用插件化架構,開發者可以通過掛載不同的 profile 插件來擴展 Agent 的能力。在開發 profile 時,集成一套現成的技能集(如 obra Superpowers)能顯著提升開發效率。@anht3889/dsh-superpowers 插件解決了兩個具體問題:一是自動將 Superpowers 的技能文件掛載到 DSH 上下文中,二是確保 Agent 在會話開始時知曉使用該技能集的上下文和方法。
這是什麼¶
@anht3889/dsh-superpowers 是一個 DeepSeek Harness profile 插件,由開發者 anht3889 維護,採用 MIT 許可證。它作爲一箇中間層,將 obra 的 Superpowers 技能體系集成到 DSH 的 Skill 機制中,並負責在會話初始化時注入必要的系統提示。
核心功能¶
-
掛載技能
插件在 profile 加載時會解析 Superpowers 的skills/目錄,註冊一個隔離的dsh-skill-filesystem提供者(providerName: superpowers)。這使得 Agent 可以通過skill工具正常加載和使用這些技能。 -
註冊引導
插件會在首次模型請求前,註冊一個名爲superpowers:bootstrap的系統提示部分。該部分基於using-superpowers/SKILL.md生成,向 Agent 說明如何使用這些技能,同時包含 DeepSeek Harness 關於skill工具的簡短說明。
安裝與啓用¶
可以通過官方命令直接安裝:
npx @deepseek-ai/dsh plugin --profile web add @anht3889/dsh-superpowers
npx @deepseek-ai/dsh plugin --profile headless add @anht3889/dsh-superpowers
典型用法¶
本地開發時,需要先構建插件包,再將其添加到 profile:
pnpm install
pnpm run build
dsh plugin --profile <name> add /path/to/dsh-superpowers
在 profile 的 cordis 配置中,可以設置 injectBootstrap 爲 false 來跳過引導提示的注入(默認爲 true):
- name: '@anht3889/dsh-superpowers'
config:
injectBootstrap: false
注意事項¶
-
不要重複掛載
不要在同一個 profile 中重複掛載該插件,也不要手動複製 Superpowers 技能文件到~/.dsh/skills目錄,這會導致技能名稱衝突並造成目錄混亂。 -
技能來源
技能文件不直接提交到本倉庫,而是在構建(prepack腳本)時從上游 Superpowers 複製到vendor/superpowers/目錄,隨 npm 包一起分發。 -
依賴鎖定
Superpowers 依賴被鎖定在特定 commit86babb6(對應v6.3.0標籤),這防止了上游無聲變更導致插件行爲不一致。
適用場景¶
該插件適用於需要使用 obra Superpowers 技能集的 DeepSeek Harness profile 開發場景。插件以當前進程權限運行,使用前請檢查源碼與許可證。
總結¶
通過該插件,DSH profile 可以快速集成 Superpowers 技能體系,無需手動管理文件掛載。更多詳情請參考插件目錄或源碼倉庫。