前言¶

DeepSeek Harness (DSH) 內置的 skill 工具依賴模型自行發現並加載技能，這往往導致有用的技能被遺漏，且本地技能文件難以進行生命週期管理。dsh-skills-manager 旨在解決這些問題，通過主動匹配和鉤子機制，填補了現有工具的空白。

這是什麼¶

這是由 Wisdoverse 維護的一個 DSH 插件，負責 DeepSeek Harness 的技能管理。它提供主動技能激活、觸發鉤子編排、GitHub 源同步以及內置的設置管理界面。

核心功能¶

• 主動激活：自動加載強匹配的技能，並建議弱匹配的技能。
• 技能級鉤子：支持 UserPromptSubmit、PreToolUse、PostToolUse、PostToolUseFailure 和 SessionStart 事件。
• GitHub 生命週期管理：支持技能的安裝、更新、同步和卸載。
• 工作區感知作用域：項目級技能覆蓋用戶級技能，且配置不會在不同工作區間泄漏。
• 內置管理：提供設置管理 UI 以及 skill_manager 模型工具。
• 安全防護欄：包含源白名單、鉤子路徑驗證，且鉤子運行在沙盒環境中，禁止 Shell 執行。

安裝與啓用¶

在安裝前，請確保環境滿足以下依賴：
* DeepSeek Harness 版本：0.1.1-rc.2、0.1.2-alpha.3、0.1.3-alpha.1 或 0.2.0-rc.2
* Node.js 版本：^22.19.0 或 >=24.0.0
* pnpm 已在 PATH 中可用

使用以下命令安裝插件：

dsh plugin --profile web add @wisdoverse/dsh-skills-manager

安裝、更新或移除插件後，必須重啓 Web profile 以使配置生效。

典型用法¶

技能配置示例¶

在 SKILL.md 的 frontmatter 中聲明激活模式和鉤子：

---
name: repo-hardening
description: Review and harden a repository with build/test gates.
metadata:
  activation: auto             # auto | suggest | off
  triggers:
    - "harden"
    - "build fails"
  hooks:
    UserPromptSubmit:
      inject: "Run build and tests before reaching a conclusion."
    PreToolUse:
      - tool: bash
        when: "git push"
        decision: deny
        reason: "Direct pushes are not allowed"
    SessionStart:
      activate: true
---

常用管理命令¶

# 更新插件
dsh plugin --profile web update @wisdoverse/dsh-skills-manager

# 移除插件
dsh plugin --profile web remove @wisdoverse/dsh-skills-manager

適用場景與注意¶

此插件適合需要精細控制技能加載時機、跨項目管理技能以及通過 GitHub 管理技能生命週期的場景。

• 運行環境：插件以當前 DSH 進程權限運行，鉤子邏輯在沙盒環境中執行，禁止 Shell 執行。
• 安全檢查：在安裝前建議查看源碼與許可證（MIT）。

結尾¶

dsh-skills-manager 通過主動激活和鉤子機制，增強了 DSH 處理複雜工作流的能力。更多細節可參考插件目錄或 GitHub 源碼。