在 DSH 中直接讓模型進入編碼階段,往往缺乏結構化的前置步驟,容易導致調試困難或需求遺漏。dsh-superpowers 移植了 obra/superpowers 的技能框架,爲 DSH 引入了 14 個預定義的軟件開發技能和會話啓動引導。這套框架強制模型在動手之前先進行頭腦風暴、制定計劃,並在開發、測試、調試和評審環節遵循既定流程。
這是一個由 TangYT 維護的 DSH 插件,採用 MIT 許可證。它將上游的技能文件與 DSH 原生工具映射結合,通過會話啓動時的系統提示注入,讓模型能夠自動調用這些技能。
核心功能¶
該插件主要包含以下能力:
- 14 個開箱即用技能:覆蓋從需求分析到代碼合併的全流程。
- 會話啓動引導:在每次新會話開始時,系統提示中會自動注入技能使用規則,確保模型按規範工作。
- DSH 原生工具映射:將技能中的動作語言翻譯爲 DSH 的原生工具,例如
subagent(派發子代理)、todo_write(創建待辦)、pwsh/bash(執行命令)等。 - 零依賴與熱更新:基於 Node.js 內置模塊實現,修改技能文件後無需重啓,下次加載即時生效。
- 一鍵同步上游:提供腳本從 pin 定的上游版本重新拉取技能內容。
技能清單¶
插件內置的 14 個技能及其觸發場景如下:
| 技能名稱 | 觸發場景 |
|---|---|
brainstorming |
任何創造性工作前,澄清意圖、需求與設計 |
writing-plans |
有需求或規格時,動手寫代碼前制定實施計劃 |
executing-plans |
在獨立會話中執行書面實施計劃,帶評審檢查點 |
subagent-driven-development |
每個任務派發全新實施子代理,並進行任務與全分支評審 |
test-driven-development |
實現功能或修 bug 前,強制執行紅-綠-重構流程 |
systematic-debugging |
遇到 bug 或測試失敗時,先進行根因分析再修復 |
requesting-code-review |
完成任務或合併前,請求評審驗證 |
receiving-code-review |
收到評審意見後,如何覈實與回應 |
using-git-worktrees |
需要隔離工作區時使用 git worktree |
dispatching-parallel-agents |
派發 2 個或更多無共享狀態的獨立任務並行執行 |
verification-before-completion |
聲稱完成任務前,必須運行驗證命令獲取證據 |
finishing-a-development-branch |
實現完成後,如何進行集成、合併或清理 |
writing-skills |
編寫、修改或驗證新技能本身(元技能) |
using-superpowers |
會話開始時如何發現與調用技能 |
安裝與啓用¶
安裝該插件需要使用 DSH 的插件命令。
dsh plugin --profile <profile> add git+https://gitee.com/tang-yongtao/dsh-superpowers.git
安裝完成後,必須重啓 dsh web 進程才能使插件生效。重啓後,新會話的系統提示中會出現 You have superpowers. 的引導段,技能目錄中也應包含上述 14 個技能。
使用方式¶
技能的調用主要通過自然語言觸發,無需記憶特定命令。
- 自然語言觸發:直接在對話中提出需求。例如說“幫我頭腦風暴一個新功能”,模型會自動調用
brainstorming技能;說“這個 bug 查下根因”,會調用systematic-debugging。 - 斜槓命令調用:在輸入框輸入
/,命令菜單中會列出所有技能(如/brainstorming)。選中或直接輸入技能名發送,即可顯式注入該技能。 - 列出技能:在對話中詢問“你現在有哪些技能?”,模型會列出當前可用的技能列表。
- 跳過技能:用戶擁有最高優先級。如果不想使用某個技能,可以直接說“不用頭腦風暴,直接改”,模型將忽略該技能。
配置說明¶
在插件的配置中,可以控制是否在會話啓動時注入引導信息。
編輯 profile 中該插件的行配置(bundle patch 的 config):
config:
bootstrap: false # 關閉會話啓動注入(保留技能 provider)
開啓 bootstrap 會導致系統提示每請求多出約 5-6KB 的前綴內容。如果介意 token 開銷,可以選擇關閉此項,但模型將不再自動檢查是否有匹配技能。
注意事項¶
- 重啓生效:安裝後務必重啓
dsh web,否則技能不會加載。 - Token 開銷:開啓 bootstrap 會增加每輪請求的系統提示長度。
- Web UI 依賴:
brainstorming技能包含一個可選的 Web UI(位於skills/brainstorming/scripts/),但其依賴的 bash 腳本在 Windows 上需要 WSL 或遠程 Linux 環境。 - 版權歸屬:技能內容(正文)版權歸 obra (Jesse Vincent) 所有,本倉庫僅做移植層(bootstrap/provider/工具映射)與同步腳本。
總結¶
dsh-superpowers 通過引入標準化的 Agentic 技能和工作流,降低了在 DSH 中使用複雜軟件工程方法的門檻。對於希望提升代碼質量和開發流程規範性的用戶,這套技能框架提供了從規劃到合併的完整閉環支持。
項目目錄:https://www.skillhub.cn/plugins/TangYT/dsh-superpowers
GitHub 倉庫:https://github.com/TangYT/dsh-superpowers