dsh-skill-starter:DSH 技能管理器與中文工程流程技能包

前言

在 DeepSeek Harness(DSH)裏,技能(skill)是把一套固定做法寫進一個文件,之後每次對話都能按同一流程執行。實際用起來,文件會散在多個目錄、frontmatter 格式要記、裝多了想不起該用哪個,升級技能包還擔心覆蓋本地改過的內容。

社區裏已有彙總散落技能、或做本地瀏覽的插件;dsh-skill-starter 側重的是技能內容本身與分發:裝完就有可用的基礎技能和一箇中文工程流程包,設置頁按「你遇到的問題」分組,模型也可以在對話裏直接讀寫技能庫。下面介紹它是什麼、怎麼裝、典型用法和注意事項。

這是什麼

  • 名稱:dsh-skill-starter(npm 包名相同)
  • 維護者:ymck-x
  • 分類:工作流(社區目錄 SkillHub 插件頁)
  • 版本(資料中 package.json):0.3.0
  • 許可:MIT

一句話:DSH 技能管理器——自帶 6 個基礎技能與 engineering-zh 技能包(20 箇中文工程流程技能);設置頁可查看、編輯、新建;升級技能包不覆蓋你改過的文件。

核心功能

裝完即得的內容

內容 說明
6 個基礎技能 如 ask-first(需求沒說清先問完)、prove-it(改之前說清怎麼驗證)、write-my-skill(一句話記成技能)等
20 個工程流程技能 技能包 engineering-zh:拷問需求 → 收規格 → 拆票 → 實現 → 雙軸審查 → 復盤,以及診斷 bug、TDD、原型、研究、教學等
按症狀分組的面板 設置頁「Skill 管理」按「你遇到的問題」分組,不必死記技能名
「我該用哪個」對照表 29 行處境對照,點一行跳到對應技能;與 skills-map 技能同源解析,避免面板與路由表不一致
對話內讀寫 註冊六個工具,AI 可列出、讀取、寫入、刪除技能,以及列出/安裝技能包

升級技能包時:你改過的文件會跳過並在結果中點名;已存在且內容不同的絕不覆蓋;內容相同則只登記指紋。插件只加新技能、修錯字,不碰你動過的行。

設置頁「Skill 管理」

打開「設置 → Skill 管理」,看到的是按問題分的組(例如「開工之前」「別讓它做錯方向」「別讓『改好了』是空話」),每組下列出對應技能。可選中一條編輯名稱、描述、使用時機、正文及調用開關;可新建、刪除,或將內置技能複製後再改。界面隨語言中英雙語。

模型側六個工具

工具 作用
skill_list 列出全部技能:來源、調用方式、是否被覆蓋、附件數
skill_read 讀出完整內容與附件清單
skill_write 新建或修改
skill_delete 刪除
skill_pack_list 技能包狀態
skill_pack_install 安裝或升級,不覆蓋你的改動

例如你說「把這套流程記下來」,模型可通過 skill_write 直接落盤,格式由插件約束。

不需要工具帶來的上下文開銷時,可在配置中關閉:

- id: dsh-skill-starter
  config:
    enableTools: false

關閉後模型側工具 schema 開銷歸零,設置面板與「我該用哪個」表仍可用(表走面板接口,不進模型上下文)。資料中估算:自帶 6 技能 + 技能包 20 技能 + 六工具 schema,合計約 1737~3474 token(裝了技能包且開啓工具時)。

技能的三種來源與優先級

來源 位置
項目級 <項目>\.dsh\skills\、<項目>\.agents\skills\
用戶級 ~\.dsh\skills\(面板與工具主要管這裏)
內置 插件 skills\(只讀;用戶目錄同名文件可覆蓋)

同名時:項目級 > 用戶級 > 內置。面板列用戶級與內置;項目級技能可在對話裏讓 AI 列出。

與同類插件

插件 側重
dsh-skills 彙總各處技能入庫、引用或副本、導出
asakumizy/dsh-local-skills 本地技能瀏覽器
dsh-skill-starter 自帶可用技能 + 技能包分發、升級與本地改動保護

三者 id 不同可並存,但同一技能名不要裝兩份,否則會重複註冊。

安裝與啓用

DSH 生態裏插件通過 profile 安裝;desktop 需換成你 ~/.dsh/profiles/ 下實際的 profile 目錄名。

先做安裝,再重啓 dsh:

dsh plugin --profile desktop add dsh-skill-starter

包在 npm:https://www.npmjs.com/package/dsh-skill-starter。

驗證:設置頁出現「Skill 管理」,或在對話裏問「我有哪些技能」。

裝不下來時改用固定 tag 源碼包

網絡或鏡像異常時,使用 README 中的完整 tag 地址(勿改成 refs/heads/main.tar.gz 或 github:owner/repo 簡寫):

dsh plugin --profile desktop add https://github.com/ymck-x/dsh-skill-starter/archive/refs/tags/v0.3.0.tar.gz

換版本時需手改 URL 中的 tag 號。

沒有 dsh 命令時手動裝

在 profile 目錄執行 pnpm,並把包名寫入 dsh.profile.bundles:

cd ~/.dsh/profiles/desktop
pnpm add dsh-skill-starter

npm 不可用時,將 dsh-skill-starter 換成上述 GitHub tag tarball 地址。

在同級 package.json 的 bundles 中加入 dsh-skill-starter,例如:

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-skill-starter"
      ]
    }
  }
}

重啓 dsh 生效。

卸載

dsh plugin --profile desktop remove dsh-skill-starter

手動安裝時從 bundles 刪除該項並 pnpm remove dsh-skill-starter。卸載不會刪除你在 ~\.dsh\skills\ 裏寫的技能。

典型用法

  1. 按處境選技能:在設置頁打開「我該用哪個」,對照當前處境(如「需求沒說清」→ ask-first,「做完了不知道有沒有問題」→ code-review),點一行進入對應技能編輯或記名後在對話裏 /技能名 調用。

  2. 安裝中文工程包:通過面板或讓 AI 執行 skill_pack_install 安裝 engineering-zh。之後可按流程手動發起 /to-spec、/to-tickets、/implement 等(部分技能僅允許人工 / 發起,避免 AI 擅自改變工作狀態)。

  3. 沉澱個人做法:對話中說「把這條記下來」「以後都這樣做」,配合 write-my-skill 或 skill_write 寫入用戶級技能目錄。

  4. 改包內技能:直接在 ~\.dsh\skills\ 改對應文件;下次升級包時你的修改不會被覆蓋。

技能分模型可調用與僅人工發起兩類:前者任務匹配時 AI 可自動用,也可 /名字;後者只有你 /名字 才生效(如 to-spec、retro、handoff 等)。

適用場景與注意

適合誰:希望在 DSH 裏有一套開箱可用的中文工程協作流程、又需要可視化管理技能且擔心升級沖掉本地修改的開發者。

運行與信任:插件以當前 DSH 進程權限運行,會讀寫用戶技能目錄並註冊模型工具。安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證,確認符合你的環境策略。

環境:package.json 要求 Node ^22.19.0 || >=24.0.0。

生態說明:DSH 社區插件目錄(如 SkillHub)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;「一切皆插件」是 DSH 的產品思路,本文僅介紹社區維護的 dsh-skill-starter。

結尾

dsh-skill-starter 把「有技能可用、知道何時用、改完不怕被升級覆蓋、對話裏也能管庫」收在一個工作流插件裏:6 個基礎技能 + 可選的 20 項中文工程包,加上按症狀分組的設置頁與 29 行處境對照表。

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

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

小夜