dsh-superpowers:DeepSeek Harness Agentic 技能框架

在 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 個技能。

使用方式

技能的調用主要通過自然語言觸發,無需記憶特定命令。

  1. 自然語言觸發:直接在對話中提出需求。例如說“幫我頭腦風暴一個新功能”,模型會自動調用 brainstorming 技能;說“這個 bug 查下根因”,會調用 systematic-debugging。
  2. 斜槓命令調用:在輸入框輸入 /,命令菜單中會列出所有技能(如 /brainstorming)。選中或直接輸入技能名發送,即可顯式注入該技能。
  3. 列出技能:在對話中詢問“你現在有哪些技能?”,模型會列出當前可用的技能列表。
  4. 跳過技能:用戶擁有最高優先級。如果不想使用某個技能,可以直接說“不用頭腦風暴,直接改”,模型將忽略該技能。

配置說明

在插件的配置中,可以控制是否在會話啓動時注入引導信息。

編輯 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

羽毛球分组比赛记分
小程序二维码

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

小夜