技能搬家助手mjylfz/dsh-skill-mover

English  |  简体中文

DSH Skill Mover（技能搬家助手）

把电脑上其他 Agent 已经装好的技能，一键搬进 DeepSeek Harness。

支持 Cursor / Claude Code / Codex / OpenCode / Hermes / OpenClaw / Kimi / Trae / Trae CN / CodeBuddy / Qwen Code / Qoder / Qoder CN / QoderWork 等 14 个平台的技能扫描与迁移：自动识别共享层（~/.agents/skills）、同名技能自动合并、重复的技能不会搬两份，迁移后 DSH 马上就能用。

界面预览

Skill 迁移主界面

设置 → Skill 迁移：按平台分组展示本机扫描到的技能，勾选后一键迁移。

功能特性

- 🔍 自动扫描：打开页面就能看到电脑上所有 Agent 都装了哪些技能，一目了然
- ☑️ 勾选即迁移：想搬哪个勾哪个，一次可以搬几十个
- 🧩 同名自动合并：同一个技能在多个 Agent 里都有时，只装一份，来源随便你选
- 🔗 不会重复搬运：好几个 Agent 其实用的是同一份技能，这种情况会自动识别，只算一次
- ↩️ 随时反悔：迁移错了可以一键移除，不影响其他已安装的技能
- 📦 原样复制，原目录不动：DSH 里是独立副本，原 Agent 照常使用
- 🧹 自动整理：不规范的技能名会自动改成 DSH 认识的格式，保证迁移后可用
- 🌍 三大系统都支持：macOS / Linux / Windows

| 平台 | 技能目录（macOS/Linux） | Windows |
|---|---|---|
| 共享层（DSH 原生） | ~/.agents/skills | C:\Users\\.agents\skills |
| Codex | ~/.codex/skills | C:\Users\\.codex\skills |
| Claude Code | ~/.claude/skills | C:\Users\\.claude\skills |
| Cursor | ~/.cursor/skills | C:\Users\\.cursor\skills |
| OpenCode | ~/.config/opencode/skills | C:\Users\\.config\opencode\skills |
| Hermes Agent | ~/.hermes/skills | C:\Users\\AppData\Local\hermes\skills |
| OpenClaw | ~/.openclaw/skills | C:\Users\\.openclaw\skills |
| Kimi Code CLI | ~/.kimi/skills | C:\Users\\.kimi\skills |
| Trae（国际版） | ~/.trae/skills | C:\Users\\.trae\skills |
| Trae CN（国内版） | ~/.trae-cn/skills | C:\Users\\.trae-cn\skills |
| CodeBuddy | ~/.codebuddy/skills | C:\Users\\.codebuddy\skills |
| Qwen Code | ~/.qwen/skills | C:\Users\\.qwen\skills |
| Qoder CLI | ~/.qoder/skills | C:\Users\\.qoder\skills |
| Qoder CN CLI | ~/.qoder-cn/skills | C:\Users\\.qoder-cn\skills |
| QoderWork | ~/.qoderwork/skills | C:\Users\\.qoderwork\skills |

路径均经过官方文档或源码核实，详见 docs/agent-skills-migration-research.md。

安装

一条命令永久安装（推荐）：

dsh plugin --profile web add github:mjylfz/dsh-skill-mover

安装完成后重启 DSH，打开 设置 → Skill 迁移 即可使用。

免安装试用（会话级）：把仓库链接 https://github.com/mjylfz/dsh-skill-mover 发给你的 DSH 助手，说「帮我安装这个插件并运行」，助手会自动读取插件文件并加载；批准运行后同样在 设置 → Skill 迁移 使用（会话级插件重启后需重新加载）。

使用

1. 打开 设置 → Skill 迁移
2. 页面自动扫描本机各 Agent 的技能目录，按平台分组展示
3. 展开平台卡片查看技能列表，勾选要迁移的技能（同名多来源技能可展开切换来源）
4. 点底部「迁移所选 N 个技能」（固定复制模式：DSH 内是独立副本，原目录删除不受影响）
5. 迁移完成后 DSH 自动发现新技能，无需重启；结果页可「移除本次迁移」回滚

交互规则

- 标着「DSH 原生支持」的共享层技能默认就是勾选状态，不用管它——DSH 本来就能直接用
- 同一个技能在多个平台都有时，勾选任何一个平台的版本，就等于选了那个平台的来源，其他平台栏会同步变化
- 已经在 DSH 里的技能默认不勾选，避免重复安装（想更新覆盖就勾「覆盖已安装」）
- 和共享层其实是同一份的技能（比如只是链接过去的）默认不勾选，搬了也是重复

迁移后能不能直接用？

能。技能是一份「说明书 + 配套素材」，不是安装包。迁移后：

- DSH 马上就能认出它：AI 在遇到相关任务时，会自动打开这份说明书照着做，不需要你额外操作（已经实测验证）
- 个别技能需要程序库：比如要用到 Python 的库、Node 的包。DSH 不会偷偷执行安装命令（防止来源不可信的技能乱装东西）。如果技能确实需要这些库，AI 会按说明书自己安装；迁移结果页也会提示你哪些技能带了依赖声明，必要时手动装一次即可

常见问题

Q: 迁移后怎么使用这个技能？需要额外操作吗？

不需要额外操作。迁移后 DSH 会自动识别技能，AI 在遇到相关任务时会自动调用。你也可以直接说，例如「用 baoyu-cover-image 给这篇文章生成封面」。如果技能没有自动触发，明确说一句「请使用 xx 技能」即可。

Q: 迁移会影响原来的 Agent 吗？

不会。迁移是复制，不是移动。原目录原样保留，原来的 Agent 照常使用。

Q: 同一个技能在多个平台都有，会装重复吗？

不会。同名技能会合并成一组，只迁移一份，来源可以自己选（默认推荐共享层或优先级最高的来源）。

Q: 迁移后技能找不到或不生效怎么办？

先看技能是否出现在 ~/.dsh/skills/ 目录下；再确认技能的说明文件格式没问题（插件迁移时会自动修正不规范的名字）；最后开一个新会话再试。

Q: 技能需要安装依赖（pip / npm）吗？

看技能本身。纯指令型技能直接可用；带脚本依赖的技能，AI 会按技能的说明自动安装，或者按迁移结果页的提示手动安装。插件不会自动执行安装脚本（安全考虑）。

Q: 怎么撤销迁移？

迁移结果页点「移除本次迁移」，本次迁移的技能会被删除，原目录不受影响。

Q: Windows 支持吗？

支持。路径规则、复制命令（robocopy）和链接方式（junction）都已按 Windows 适配。

项目结构

dsh-skill-mover/
├── skill-migrator-host.js      # 插件 Host 半：扫描 / 冲突规划 / 迁移执行 / RPC
├── skill-migrator-client.js    # 插件 Client 半：设置页 UI（settings.section）
├── docs/
│   ├── agent-skills-migration-research.md   # 15 个平台技能目录调研
│   └── dsh-skill-migrator-design.md         # 完整设计文档（架构 / 冲突策略 / Windows 验证）

开发与测试

插件为纯 JavaScript（无构建步骤），Host 侧无外部依赖（手写 frontmatter 解析器、路径工具），通过 DSH 的 ctx.fs / ctx.shell 服务工作。

本地回归测试方法：用 mock 的 fs/shell 服务 + 真实文件系统运行 runScan / runMigrate / runRemove，并用 DSH 官方 dsh-skill-filesystem 发现器验证迁移后的技能可被发现、可完整加载（已实测通过）。

许可证

MIT