superpowers-dsh：給 DeepSeek Harness 裝上 TDD、調試與規劃技能

DeepSeek Harness 插件 DeepSeek DSH 技能 TDD superpowers-dsh 2026-08-17 150 閱讀

前言

DeepSeek Harness（下文簡稱 DSH）把模型、工具、技能、會話、沙箱和界面都做成可裝卸的插件。官方倉庫的定位就是「Everything is a Plugin」：能力不寫死在內核裏，而是掛到 Cordis 的共享上下文上，按 profile 組合。技能（skills）也屬於這一層——它們不是新工具，而是一段段可被 skill 工具加載的工作紀律。

編碼智能體接到「加個功能」「修個 bug」時，常見做法是直接改代碼。設計沒對齊、測試沒先紅、根因沒查清，下一輪又在症狀上打補丁。Jesse Vincent 維護的 obra/superpowers 把這套流程拆成可組合技能：先頭腦風暴，再寫計劃，實施走 RED-GREEN-REFACTOR，調試先查根因。上游倉庫以 MIT 協議開源，官方 README 給出了 Claude Code、Cursor、Codex、Gemini CLI 等多套安裝方式，但列表裏沒有 DeepSeek Harness。

superpowers-dsh 做的就是這件事：把 Superpowers 的核心技能移植到 DSH 的 Cordis 插件架構上，隨包分發 SKILL.md，安裝後註冊進 host 層技能表。本文根據插件目錄頁、GitHub 倉庫 README、package.json、lib/index.js 以及上游 Superpowers 資料交叉覈對後寫成，寫作日期爲 2026-08-17。

這是什麼

superpowers-dsh 是一款 技能類 DSH 插件，由 LayneChai 維護，倉庫地址是 LayneChai/superpowers-dsh。社區插件目錄把它歸在「技能」分類，收錄日期爲 2026-08-15。它不是 DeepSeek / 幻方的官方組件；deepseek-harness-plugin.com 是獨立的社區目錄，與 DeepSeek 官方無從屬關係。官方發現渠道仍是 GitHub 的 dsh-plugin topic。

一句話定位：安裝後，當前 profile 裏的每個 agent 會話都能在技能目錄裏看到 14 個 Superpowers 技能，並用 DSH 自帶的 skill 工具按需加載。技能正文在包內的 skills/<name>/SKILL.md，通過 import.meta.url 定位，不需要用戶再配路徑。

倉庫創建於 2026-08-14，主要語言是 JavaScript。本文寫作時 GitHub 顯示 44 星；目錄頁當時仍顯示 27 星，以倉庫頁面爲準。npm 包名同樣是 superpowers-dsh，頁面上的最新版本是 0.1.1（2026-08-14 發佈）；GitHub main 分支的 package.json 仍寫 0.1.0。從 GitHub 規格安裝會跟隨倉庫當前提交，從 npm 安裝會拿到已發佈版本，兩者不必視爲同一份產物。

核心功能

插件向 ctx.skills 註冊表的 host 層 註冊一個技能提供者。host 層的行會進入每個 agent preset 的作用域鏈，所以不必給每個 agent 單獨再裝一遍。lib/index.js 的實現很薄：只使用 Node 內置的 fs / path / url，消費注入的 ctx.skills 服務。list() 掃描包內 skills/ 目錄，從 YAML frontmatter 解析 name、description、whenToUse；get() 按需讀正文，並把 resourceBase 指到技能目錄，相對引用（腳本、提示模板）才能解析。

cordis.patch.yml 在 dsh-base 層之上插入一行：

- insert:
  - id: superpowers-dsh
    name: 'superpowers-dsh'

後面的 profile 層和 --patch 疊加仍可按 id 找到這一行。

README 列出的 14 個技能可以按用途分成幾組。下面的說明來自倉庫技能表和已打開的 SKILL.md，不是使用體驗評價。

入口

  • using-superpowers：怎麼查找和調用技能。正文要求：只要有一點可能適用，就先用 skill 工具加載，再說話或動手。DSH 上技能用裸名稱尋址，例如 brainstorming，不再帶 superpowers: 前綴。

規劃與協作

  • brainstorming：用協作對話把想法收斂成設計。
  • writing-plans：根據規格寫實施計劃。
  • executing-plans：按書面計劃執行，並留下評審檢查點。

實施與驗證

  • test-driven-development：RED-GREEN-REFACTOR。倉庫裏的技能正文把「沒有先看到失敗測試，就不寫生產代碼」寫成硬規則；原型、生成代碼、配置文件需要先問使用者。
  • systematic-debugging：四階段調試——根因調查、模式對比、單假設驗證、再動手修。技能正文寫明：沒完成第一階段，不能提修復方案。
  • verification-before-completion：聲稱完成之前先拿出證據。

多代理

  • subagent-driven-development：每個任務派發新的子代理並評審。
  • dispatching-parallel-agents：把可獨立的工作扇出到並行代理。移植說明裏，子代理引用映射到 DSH 的 subagent / subagent_fork；大規模扇出還可以用 DSH 自己的 workflow 工具。

評審與收尾

  • requesting-code-review / receiving-code-review：合併前做嚴格評審，收到意見先覈實再改，而不是照單全收。
  • finishing-a-development-branch：安全整合已完成的工作。
  • using-git-worktrees：功能開發用隔離工作區。

擴展

  • writing-skills：以 TDD 方式編寫並驗證新技能。往包裏再放一個帶 YAML frontmatter 的 skills/<name>/SKILL.md 即可被 list() 發現，不必改插件代碼。

相對上游，移植做了幾處平臺適配，都寫在 README 的「移植說明」裏：

  1. 去掉命名空間前綴，適配 DSH 的裸名稱尋址。
  2. using-superpowers 指向 skills/using-superpowers/references/dsh-tools.md，給出 Claude Code 工具到 DSH 的對照（pwsh / bash、subagent、workflow、goal 等）。DSH 沒有 hook 系統，工作流約束寫在技能正文裏。
  3. brainstorming 的視覺伴侶：Node 服務 scripts/server.cjs 全平臺可跑；.sh 輔助腳本只在 bash 下可用。

安裝與啓用

目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行即可：

dsh plugin add github:LayneChai/superpowers-dsh

插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。需要可復現安裝時，把規格釘在具體 commit 上。本文覈對 main 時，最新提交是 49e2d65db55b4d3ec065ad824efe9b09465c8a26（2026-08-14）：

dsh plugin add github:LayneChai/superpowers-dsh#49e2d65db55b4d3ec065ad824efe9b09465c8a26

commit 會繼續前進，安裝前以倉庫頁面爲準。

倉庫 README 補充了若干等價寫法，面向已經在用 --profile 的用戶。dsh plugin 內部會調用 pnpm，需要先能執行 pnpm --version。dsh 命令隨 Harness 提供，常見啓動方式是 npx @deepseek-ai/dsh web，所以它只在該進程環境裏可用。可以先全局安裝，也可以全程加 npx：

# 全局安裝（README 推薦）
npm install -g @deepseek-ai/dsh
dsh --version

# 不裝全局，所有命令用 npx
npx @deepseek-ai/dsh --version

README 寫的「最簡單一條命令」（不要求先全局安裝 dsh）：

npx @deepseek-ai/dsh plugin --profile web add github:LayneChai/superpowers-dsh

從 npm 安裝（包名 superpowers-dsh）：

dsh plugin --profile web add superpowers-dsh

注意：必須走 dsh plugin。直接 npm install superpowers-dsh 只會把包當普通庫裝到當前目錄，不會寫入任何 DeepSeek Harness profile，技能不會被加載。

也可以用完整 Git URL、tarball 或本地文件夾：

dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.git

bundle 層在 profile 啓動時掛載。裝完後需要停掉再重新運行 dsh web（或 npx @deepseek-ai/dsh web），然後刷新瀏覽器。確認層已經組合進去：

dsh --profile web --dump-config

輸出裏應當出現 superpowers-dsh 這一行。headless / tui / 自定義 profile 把 --profile 換成實際在用的名字即可。卸載同樣要指定 profile，卸完也要重啓：

dsh plugin --profile web remove superpowers-dsh

README 還提到一種方式：在 Web 界面新建對話，把倉庫鏈接發給智能體，讓它代跑 dsh plugin --profile web add。這依賴當前環境裏的智能體是否會執行安裝命令，不能代替你自己檢查源碼。

典型用法

安裝並重啓 profile 之後，這 14 個技能會出現在 agent 的技能目錄裏。入口技能是 using-superpowers。DSH 用 skill 工具按名稱加載技能正文，倉庫參考文檔裏的調用形式是：

skill(name: "brainstorming")

其他技能同樣用裸名稱，例如 writing-plans、systematic-debugging、test-driven-development。using-superpowers 寫明：使用者寫在 AGENTS.md 或會話系統提示裏的指令優先於技能；技能再覆蓋默認行爲。只有在人明確要求跳過時，纔可以不走技能流程。DSH 沒有 Claude Code 那種 CLAUDE.md 自動裝載，持久項目說明應放在 AGENTS.md。

上游 Superpowers README 給出的基本工作流，移植後仍然按這個順序理解（技能名已去掉前綴）：

  1. 要做新功能時，先加載 brainstorming，把目標和約束問清楚，再進入設計。
  2. 設計認可後，用 writing-plans 拆成帶路徑、驗證步驟的實施計劃。
  3. 實施階段加載 test-driven-development：先寫失敗測試並確認它因爲缺功能而失敗，再寫最少代碼讓它通過，最後重構。
  4. 遇到失敗或異常行爲，先加載 systematic-debugging，完成根因調查再改代碼。
  5. 任務之間可用 requesting-code-review；全部完成後走 finishing-a-development-branch。

這些步驟來自上游 README 與本插件技能列表的對應關係，不是某次真實會話的實錄。插件本身不新增模型可調用的業務工具，它只把技能正文送進上下文；具體是否遵守，取決於當前模型和會話指令。

適用場景與注意事項

比較適合已經在跑 DeepSeek Harness、希望智能體按軟件工程節奏做事的人：新功能從設計到計劃、修 bug 時先查根因、需要子代理分任務或並行、以及想在 DSH 裏沿用 Superpowers 那套技能名的人。如果你主要用 Claude Code / Cursor，應直接安裝上游 obra/superpowers，不必繞道這個移植包。

使用前有幾件事需要說清楚：

  1. 權限與信任。插件以當前 dsh 進程的權限運行，安裝時可能執行構建腳本。社區目錄和 GitHub 都提醒：只安裝你審查過的源碼。固定 commit 哈希可以得到可復現的安裝。
  2. 許可證。README、package.json 和 npm 頁面均標註 MIT，並寫明技能內容改編自 obra/superpowers（MIT，© Jesse Vincent 及貢獻者）。倉庫當前 沒有 獨立的 LICENSE 文件，GitHub API 因此未識別許可證字段。安裝前請自行打開 README 與上游許可證覈對。
  3. 生態歸屬。這是社區維護的適配包，不是 DeepSeek Harness 官方插件商店裏的「認證應用」。目錄站點是第三方收錄。
  4. 安裝方式。dsh plugin 依賴 pnpm；裝完必須重啓 profile。不要用裸 npm install 代替。國內用戶如需加速 npm 源，README 提到可把 registry 設爲 https://registry.npmmirror.com，這是作者說明，不是必須步驟。
  5. 平臺限制。brainstorming 附帶的 .sh 腳本只在 bash 下可用；Windows 上應使用 pwsh 或倉庫提供的 Node 腳本。dsh-tools.md 還寫明：只讀沙箱裏的 pwsh 運行在 ConstrainedLanguage，需要 .NET API 時可能要提升 sandbox_permissions。
  6. 能力邊界。插件提供的是方法論文本，不會替你跑測試、也不會保證模型每次都先寫失敗用例。技能正文語氣很硬，但仍可被用戶指令覆蓋。

小結

superpowers-dsh 把 obra/superpowers 裏面向編碼智能體的 TDD、系統化調試、規劃與協作技能，接到了 DeepSeek Harness 的 host 技能註冊表上。安裝命令以目錄頁爲準：

dsh plugin add github:LayneChai/superpowers-dsh

裝完重啓 profile，用 dsh --profile web --dump-config 確認出現插件行，再用 skill 工具按裸名稱加載。源碼和許可證請在安裝前自己看一遍。

  • 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/superpowers-dsh/
  • GitHub：https://github.com/LayneChai/superpowers-dsh
  • 上游技能庫：https://github.com/obra/superpowers
  • DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness

相關文章

快速從零部署一個DeepSeek-R1服務 2025-04-05 使用 dsh-anchored-standard 爲 DeepSeek Harness 配置兩階段 Agent 預設 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 網頁界面補成工作臺 2026-08-17 用 modlens 給 DeepSeek Harness 的純文本模型補上視覺 2026-08-17 用 dsh-TUI 給 DeepSeek Harness 補上全屏終端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

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

小夜