前言¶

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