前言¶
在 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\ 裏寫的技能。
典型用法¶
-
按處境選技能:在設置頁打開「我該用哪個」,對照當前處境(如「需求沒說清」→
ask-first,「做完了不知道有沒有問題」→code-review),點一行進入對應技能編輯或記名後在對話裏/技能名調用。 -
安裝中文工程包:通過面板或讓 AI 執行
skill_pack_install安裝engineering-zh。之後可按流程手動發起/to-spec、/to-tickets、/implement等(部分技能僅允許人工/發起,避免 AI 擅自改變工作狀態)。 -
沉澱個人做法:對話中說「把這條記下來」「以後都這樣做」,配合
write-my-skill或skill_write寫入用戶級技能目錄。 -
改包內技能:直接在
~\.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 行處境對照表。