前言¶
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 倉庫。