dsh skill 安裝教學：DeepSeek Harness 技能安裝
從建資料夾到 trajectory 驗證,7 步裝好一個技能;不必重啟、沒有市集、不改任何設定檔。
最近更新: 2026-10-04
技能(Skill)是 DeepSeek Harness 裡最輕量的擴充:一個 Markdown 檔,教會 Agent 一件可重複的事。安裝技能沒有指令要找,也沒有市集要信任——所謂安裝,就是把 SKILL.md 放到 harness 會讀取的資料夾。放對了,目前對話的下一則提示詞就能用上,連重啟都不必。
以下每張截圖都來自真實錄影:一門 60 分鐘深度課程的第 17 課現場建立 release-sort 技能,外加一堂新手教學的內建技能畫面。看完這頁,你會親手裝好一個技能、親眼確認 harness 找到了它,並證明它在 新對話裡一樣生效。
七步裝好一個 DeepSeek Harness 技能
- 1
在專案裡建技能資料夾
DeepSeek Harness 從工作區根目錄的 .dsh/skills 資料夾讀取技能,一個技能一個子資料夾。課程裡建的是 release-sort——教 Agent 依日期排序發布記錄的技能。一行 mkdir 就是全部安裝動作:不下載任何東西、不改 manifest、不跑建置。Codex 風格的 .agents/skills 目錄同樣被支援;放在使用者層級 .dsh 目錄下的技能則對所有工作區生效。
$mkdir -p .dsh/skills/release-sort
裝技能從 mkdir 開始:.dsh/skills 底下建一個資料夾,就這麼簡單。看影片 31:56 處 - 2
撰寫 SKILL.md,或讓 Agent 陪你寫
一個技能就是一個 Markdown 檔。frontmatter 寫 name 與 description,描述就是觸發條件——課程裡寫的是 MUST USE when the user asks why harbor-log latest is wrong,Agent 一看就知道什麼時候該用它。內文用白話寫步驟、規則與事實(本例:01-alpha.md 的日期是 2026-08-19,99-zzz.md 是 2024-01-01,所以按日期排序而非檔名)。直接請 DeepSeek Harness 起草也完全可以;從 GitHub 拷貝來的、從 Claude Code 或 Codex 遷移來的技能,放進同一個資料夾即可。
一個 Markdown 檔:上面是觸發描述,下面是白話規則。看影片 32:44 處 - 3
送出一則對得上的提示詞,不必重啟
插件要重啟 harness,技能不用。回到同一個執行中的對話,送出一則命中技能描述的提示詞。訊息送出的瞬間,DeepSeek Harness 會注入兩列上下文:dsh 系統提示詞,以及已經包含 release-sort 的技能目錄(skill-catalog)。這次目錄注入就是檔案被找到的明確訊號——模型還沒開口,事情已經成了。
提示詞一送出,harness 就悄悄注入技能目錄——不必重啟。看影片 32:24 處 - 4
在 trajectory 裡確認技能真的載入了
打開 Trajectory 分頁看回執:先看到 available_skills 提醒列出你的技能,然後是 assistant 表示先載入相關技能,接著一行真正的 skill 工具呼叫(name: release-sort),技能內容從 .dsh/skills/release-sort 讀入。如果目錄裡根本沒有你的技能,那就是路徑或 frontmatter 寫錯了——trajectory 會告訴你錯在哪。
trajectory 就是回執:available_skills、skill 呼叫、載入內容一目瞭然。看影片 32:36 處 - 5
每個新對話都會自動帶上它
技能是專案的行李:在同一個工作區開一個全新對話,把問題再問一次,技能目錄照樣自動進入上下文。課程在新對話裡原樣重複了這個問題,得到同樣的「日期優先於檔名」結論——證明技能隨專案持久生效,不需要逐對話設定。想全域通用,就把技能放進使用者層級技能資料夾,所有工作區都帶。
全新對話問同一個問題,沒有任何針對技能的手動設定。看影片 40:24 處 
新對話結論一致——技能跟著專案走。看影片 40:48 處 - 6
你沒安裝過的技能:出廠內建與插件搭載
有兩類技能不用你動手。出廠預設技能——怎麼讀寫檔案、怎麼用 harness 工具、Cordis 插件開發指南——在每個對話裡最後載入;插件也可以自帶用法技能:插件載入時,它的技能描述會一併注入,Agent 因此知道怎麼驅動它。兩者在 trajectory 裡都看得到:技能目錄把它們和你安裝的技能列在一起。
內建技能的出現方式一模一樣:進上下文、走 skill 呼叫。看影片 9:28 處 - 7
建議不夠用時,升級成插件
技能只能建議——沒有任何機制強迫 Agent 照做。課程用四行總結收尾:技能是按名稱載入的 SKILL.md 指令;工具是真正執行的程式碼;像 /plan 這樣的指令不消耗額外模型輪次;插件則能強制——它的鉤子可以在工具執行前直接拒絕,代價是住在 repo 之外、需要重啟才生效。如果漏一步就是事故,就把技能升級;我們的《插件 vs 技能》指南專門講這個判斷。
建議、執行、快速指令、強制——選能真正把關的最輕方案。看影片 32:54 處
技能路由：讓 Harness 自己挑技能
上文裝的都是你親手選的技能。最新的一簇把方向反過來：由路由器讀任務，自己決定載入哪個技能——或哪種推論檔位。供給又新又厚：2026-09-27 實測，路由簇頭牌儲存庫已近七千星。但它回答的前置問題，仍是本頁那七步——總得有東西把檔案放到 Harness 讀得到的地方。
yjh051108/dsh-routing-suite（★6,997）
簇內頭牌：注入器加任務感知路由器，按任務在 spec / react / weak 三個行為帶之間切換。早期的 router-standard 儲存庫（★354）已併入該套件，認明單一儲存庫安裝——這也是「裝前先看 README、別抄舊教學」的現成案例。
foryourhealth111-pixel/Vibe-Skills（★3,468）
面向 AI Agent 的智慧技能路由與工作流編排，賣點可量化：README 自稱在技能密集型工作負載上獎勵提升 21 個百分點、token 省下約三成。routing-suite 路由推論檔位，Vibe-Skills 路由哪個技能出手。
路由不等於安裝
路由器決定哪個能力上場，但它裝不出不存在的技能——流程仍然從本頁走：建目錄、放 SKILL.md、看著會話目錄裡出現它。「裝哪些」的答案在我們最佳技能指南裡——路由器該指向的就是那些精選。再劃一條與模型切換的邊界：技能路由管「載入什麼」，思考等級（見切換模型一頁）管「想多深」。
DeepSeek Harness 技能 FAQ
放下第一個 SKILL.md 之前,大家最常問的幾件事。
DeepSeek Harness 的技能裝在哪個目錄?
專案技能放在工作區的 .dsh/skills/<名稱>/SKILL.md;Codex 風格的 .agents/skills/<名稱>/ 目錄同樣支援。想全專案通用,就放進使用者層級 .dsh 目錄下的技能資料夾。兩個技能同名時,dsh 依優先序號解決衝突——專案層級目錄優先於相容目錄。
加了技能之後要重啟 DeepSeek Harness 嗎?
不用。影片實錄裡,技能檔放進執行中對話所在的專案後,下一則提示詞就生效了——送出時技能目錄會重新注入。重啟是插件的事:插件接進你的 profile,要下次啟動才載入。
怎麼確認技能真的生效了?
三道檢查,從省事到確鑿:在輸入框敲一個斜線,看技能目錄裡有沒有它;送一則命中描述的提示詞,看有沒有 skill-catalog 上下文注入;打開 Trajectory,確認 skill 工具呼叫帶著你的技能名。trajectory 還會顯示解析出的基礎目錄,路徑寫錯一眼就能看出來。
Claude Code 或 Codex 的舊技能能直接用嗎?
通常可以。全域技能會被自動帶入,專案裡 .agents/skills 目錄按相容格式讀取。如果格式差異較大,Agent 可能需要一句提示或一份轉換後的副本——技能就是 Markdown 檔,改起來不費事。
技能市集在哪?可以自己寫嗎?
技能沒有官方市集——這正是它輕的地方。找技能的三個路子:GitHub 上的技能儲存庫和 awesome 清單、直接請 harness 陪你起草,或者遷移自己既有的 Codex/Claude Code 技能。自己寫時,把 description 寫成觸發條件(MUST USE when the user asks for X),目錄比對看的就是它。
技能和插件到底差在哪?
一句話:技能給建議,插件做強制。技能是 Markdown 檔,Agent 通常照做但沒人逼它;插件是裝進 profile 的 Cordis 套件,鉤子能在工具執行前直接拒絕,還可以加工具、改審批策略,但要重啟才生效。拿不準就問自己:漏一步是不是事故?是,就上插件。
有沒有官方預裝的技能？
有——dsh 自帶 skill-filesystem 等內建技能，所以你什麼都不裝時部分能力就能用。你自己的 .dsh/skills 條目與它們並列，本頁的安裝步驟對兩者完全一致：技能就是帶 SKILL.md 的資料夾，放哪裡都一樣。在客戶端的技能管理器裡可以看到你的版本帶了哪些內建技能。
相關指南
裝好第一個技能之後,接下來去哪。
dsh skill 安裝實操
把 skill 放進專案級或全域目錄，看懂呼叫開關，驗證第一次載入——12 步逐幀實錄
閱讀教學把調通的流程做成可重複使用的 dsh 技能
七張實測截圖:從你剛調通的一套流程到 SKILL.md——檔案放在哪、name、description、whenToUse 各寫什麼,以及怎麼埋一個假金鑰來驗證它真的生效。
閱讀教學外掛 vs 技能:區別在哪
一個替換 harness 能力,一個教 agent 做事。對照表 + 實機截圖 + 兩個完整例項,一次分清。
閱讀教學安全地安裝外掛
dsh 裡「安裝外掛」到底發生什麼，附一套第三方程式碼審查清單。
閱讀教學必裝 dsh 外掛推薦清單
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。
閱讀教學DeepSeek Harness 安裝教學：5 分鐘跑通 dsh
安裝 DeepSeek Harness、啟動 Web UI、完成第一個任務、選對模式。
閱讀教學升級 DSH 與外掛
經過核實的升級命令：查版本、升級 dsh CLI、在終端或 Web UI 外掛市場更新外掛，以及安全回滾。
閱讀教學最值得安裝的 dsh 技能推薦
哪些 skill 值得裝、裝完能做什麼，逐一實測示範，附啟用步驟
閱讀教學來源與致謝
截圖來自兩支公開教學:60 分鐘深度課程的第 17 課(建立並使用本機專案技能),以及一堂 15 分鐘新手教學。每張圖都可深鏈回來源影片的對應時間點。