前言¶

DeepSeek Harness（DSH）已經能通過 skill 工具和文件系統 provider 發現、加載技能目錄裏的 SKILL.md。缺口在於：如何從零寫出技能、從 GitHub 安裝別人做好的包、批量查看解析失敗的技能，以及把 Codex、Claude、Cursor 等其它 Agent 本機技能接進同一會話，往往還要自己改文件、對路徑。

dsh-skill-studio（Skill Studio / 技能工坊）由 ZTYZZ 維護，分類爲客戶端插件。它在不另起運行時、不魔改 SKILL.md 格式的前提下，補齊「做、裝、管、接」；原生仍負責「用」，卸載插件後已有技能仍可用。

這是什麼¶

一句話：在對話裏直接創建、安裝、讀取、更新、列出和刪除可複用 Agent 技能，並提供 設置 → 技能工坊 可視界面。

• 倉庫：ZTYZZ/dsh-skill-studio
• 目錄頁：SkillHub 插件條目
• 當前包版本（package.json）：1.5.1，MIT 許可證，Node.js ≥ 20

和 DSH 原生 skill 的分工¶

核心功能¶

會話內工具¶

插件另註冊運行時技能 skill-creator，指導 Agent 按規範寫技能（觸發描述、祈使正文、長內容進 references/、先校驗再交付等）。

外部 Agent 技能（只讀）¶

從 1.4.0 起註冊只讀 provider，自動發現例如 ~/.codex/skills、~/.claude/skills、~/.cursor/skills-cursor、~/.grok/bundled/skills、~/.workbuddy/skills、~/.hub/skills、~/.gemini/antigravity/skills 等；不復制文件，改原目錄後 DSH 側同步可見。配置項 autoDiscoverExternalSkills 默認 true，externalSkillDirs 可追加或設 [] 關閉。

技能工坊界面¶

路徑：設置 → 技能工坊。支持搜索、查看完整 SKILL.md、從 GitHub / 本地安裝、新建與刪除（二次確認、.trash）。通過 /skill-studio/api 與 Host 通信；POST 僅接受同端口 loopback Origin。與 DSH / 技能菜單的會話緩存不同，該頁與 skill_list 會實時反映磁盤變化。

Antigravity（agy）¶

同一套技能可接到 Antigravity：執行 node antigravity/install.mjs 後重啓 Antigravity，會寫入 ~/.gemini/config/skills.json 並安裝 skill-studio 插件。詳見倉庫內 antigravity/README.md。

安裝與啓用¶

前置條件¶

• DSH 桌面版（或其它部署），使用默認 standard 預設（已掛載 @deepseek-ai/dsh-skill-filesystem 與 @deepseek-ai/dsh-tool-skill）。
• Node.js 20+（Host 運行時一般已滿足）。

安裝 bundle¶

官方 README 要求先取得倉庫 checkout，再通過 plugin_manager 安裝本地 bundle。在對話中可讓 Agent 執行等價於 install_bundle、target 爲包絕對路徑的操作，例如：

用 plugin_manager 安裝 /絕對路徑/dsh-skill-studio 這個 DSH bundle。

管理器會把 checkout 鏈入 profile；之後在該目錄 git pull 可更新文件。若手寫 profile，可在 cordis.patch.yml 中插入：

- insert:
    - id: skill-studio
      name: dsh-skill-studio
      config: {}

優先使用 plugin_manager，便於安裝依賴並確認組合生效。

更新插件代碼¶

替換已安裝插件的 JavaScript 需在 git pull 後重啓應用，或在 設置 → 插件 裏先禁用再啓用 bundle。創建技能不需要重啓。

驗證示例：

skill_list
→ 0 skills in /Users/you/.dsh/skills

六個工具與 skill-creator 目錄項應立即可見。

配置¶

默認技能目錄爲 $DSH_HOME/skills（通常 ~/.dsh/skills）。自定義示例：

- insert:
    - id: skill-studio
      name: dsh-skill-studio
      config:
        skillsDir: /Users/you/work/skills

若改到自定義目錄，還需把該目錄加入文件系統 provider 的 customSkillDirs，否則工具能寫但目錄不會發現技能。

典型用法¶

自然語言¶

• 「把我們的每週數據分析報告做一個技能。」
• 「從這個 GitHub 地址安裝技能：https://github.com/ZTYZZ/dsh-skill-studio/tree/main/examples/release-notes」
• 「刪掉舊的 weekly-report 技能。」

推薦流程：skill_list → 接近的用 skill_read → skill_create 寫最小可用技能 → 再 skill_list / skill_read 確認 → 跑通後用 skill_update 迭代。

skill_install 來源¶

未認證 GitHub API 約每小時 60 次；更大或私有倉庫可先落到本地再用本地路徑安裝。安裝記錄寫在技能目錄內 .skill-studio.json；經 URL 安裝時二進制資源會跳過，僅文本文件。

技能包結構¶

~/.dsh/skills/
  release-notes/
    SKILL.md
    references/
      format.md

name、description 必填；name 爲 kebab-case；刪除須 confirm 與技能名一致。可選 disable-model-invocation、user-invocable、metadata 等 frontmatter。

適用場景與注意¶

適合：經常在 DSH 裏沉澱流程、需要從 GitHub 裝社區技能、要統一瀏覽本機多 Agent 技能目錄、希望用界面管理而非純手改文件的開發者。

注意：

• 插件以當前 DSH 進程權限讀寫配置的技能目錄；安裝前請審閱源碼與 MIT 許可證，並理解路徑 jail、符號鏈接攔截等安全邊界。
• skill_install 的 GitHub 方式受 API 限額約束；私有庫宜用本地路徑。
• DSH 自帶 / 技能菜單在磁盤變更後可能不會立刻刷新，查全量或排錯請用 skill_list 或技能工坊。

結尾¶

dsh-skill-studio 在兼容 DSH 原生 SKILL.md 的前提下，用六項工具、skill-creator 和技能工坊把技能的創建、安裝與運維收進會話與設置頁；並可只讀接入多 Agent 本機技能目錄，必要時通過 Antigravity 安裝腳本擴展到 agy 生態。

• 目錄頁：https://www.skillhub.cn/plugins/ZTYZZ/dsh-skill-studio
• GitHub：https://github.com/ZTYZZ/dsh-skill-studio