前言¶

在 DeepSeek Harness（DSH）插件體系裏，智能體開發常需要把“怎麼做”從提示詞建議變成可調用、可校驗的技能。@wenaixi/dsh-superpower 面向這個需求，將 obra/superpowers 的 DSH 完整移植爲 DSH 插件，把 14 個技能注入 ctx.skills，開箱即用，全中文。

這是什麼¶

Wenaixi/dsh-superpower 是 obra/superpowers 的 DSH 完整移植，npm 包名爲 @wenaixi/dsh-superpower。它提供的不是單點提示詞，而是一套強制性方法論：先設計 → 計劃切片 → TDD → 系統化調試 → 評審集成。

插件以 dsh.bundle 形式管理，隨安裝/卸載生效，不污染用戶目錄，並支持 HMR 自動重建。許可證爲 MIT，與上游 obra/superpowers 保持一致。

核心能力¶

• 14 個技能注入 ctx.skills，開箱即用，全中文。
• 提供強制性方法論：先設計 → 計劃切片 → TDD → 系統化調試 → 評審集成。
• 安裝方式支持 npm、GitHub 直裝、本地路徑、離線 tarball 安裝。
• 隨 dsh.bundle 安裝/卸載，不污染用戶目錄，HMR 自動重建。
• 自 v6.3.1 起，本倉庫脫離上游獨立演進，上游基準鎖定 obra/superpowers v6.3.0。

安裝與啓用¶

前置要求：

Node >=20
pnpm >=9
dsh

先安裝 dsh：

npm i -g @deepseek-ai/dsh

然後以 web profile 爲例添加插件：

dsh plugin --profile web add @wenaixi/dsh-superpower

其他 profile 將 --profile web 改爲對應 profile 名即可。若 npm 側出現 404 或鏡像延遲，可改用 GitHub 形式安裝；如需鎖定版本，可在包名後追加 @<version> 或 #v<version>。

注意：舊名 dsh-superpower（無 scope）已廢棄並 npm deprecate，請改用 @wenaixi/dsh-superpower。

校驗¶

安裝後，可以通過技能列表校驗：

await ctx.skills.list({cwd})

預期結果中應有 14 條 provider: superpowers。

典型用法¶

下面是可復現的技能鏈路示例：

• “幫我做 XXX” → superpower-brainstorming → superpower-writing-plans → superpower-subagent-driven-development
• “修這個缺陷” → superpower-systematic-debugging
• “幫我評審” → superpower-requesting-code-review

依賴與配置¶

package.json 中的關鍵約束如下：

{
  "name": "@wenaixi/dsh-superpower",
  "version": "6.3.1",
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-skill": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
    "@deepseek-ai/schemastery": "^3.18.1"
  },
  "dsh": {
    "bundle": {
      "patch": "./cordis.patch.yml"
    }
  }
}

也就是說，插件對 @deepseek-ai/cordis、@deepseek-ai/dsh-skill、@deepseek-ai/schemastery 有 peer 依賴要求，並通過 dsh.bundle.patch 指向 ./cordis.patch.yml。

適用場景與注意¶

適合在以下場景使用：

• 希望把開發方法論接入 DSH 的 ctx.skills，而不是隻依賴自由文本提示。
• 需要在 DSH 會話中調用設計、計劃、TDD、調試和評審等技能。
• 偏好中文技能說明，並希望插件隨 dsh.bundle 管理安裝與卸載。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• 若環境中的 DSH 相關 peer 依賴版本不滿足，需要先調整依賴版本。
• 舊包名 dsh-superpower 已廢棄，應使用 @wenaixi/dsh-superpower。

結尾¶

@wenaixi/dsh-superpower 的價值在於把 obra/superpowers 的方法論落進 DSH 插件鏈路：技能可枚舉、可校驗，安裝卸載隨 dsh.bundle 管理。

插件目錄可按 @wenaixi/dsh-superpower 查找；GitHub 倉庫：https://github.com/Wenaixi/dsh-superpower