dsh-agent-skills

把 Claude Code、Codex、Gemini CLI、Cursor 等工具的本地 Agent Skills 接入 DeepSeek Harness，并在「设置 → Agent Skills」里统一查看、启停和管理。

它解决什么问题

很多 AI 编程工具都使用 <技能名>/SKILL.md，但技能分散在不同目录。dsh-agent-skills 会自动发现这些目录，把有效技能汇总进 DSH，并提供一个可视化设置页：

• 自动发现 ~/.agents/skills、~/.claude/skills、~/.codex/skills、~/.gemini/skills 等常用目录。
• 支持添加任意自定义技能目录。
• 显示每个来源是否存在、包含多少有效技能，以及技能名称和描述。
• 可按目录或单个技能启停；变更会持久化，并在下一次 Agent step 生效。
• 监听技能文件变化，也可随时手动重新扫描。
• 不修改原始 SKILL.md 文件。

安装

方式一：DSH 插件市场（推荐）

打开 DSH 的「设置 → 插件市场」，搜索 Agent Skills，点击安装。市场会优先使用 npm 包，安装速度快，也不需要在本机重新构建。

安装后重启一次 DSH Web，再打开「设置 → Agent Skills」。

方式二：从 npm 安装

dsh plugin --profile web add dsh-agent-skills

为了让技能开关覆盖 standard 和 code Agent preset 中的 filesystem provider，还需安装一次 preset-only 行：

DSH_INSTALL_ROOT="$(npm root -g)/@deepseek-ai/dsh" \
  node ~/.dsh/profiles/web/node_modules/dsh-agent-skills/scripts/install-preset.mjs

然后重启 DSH Web。这个 preset 入口只注册 scoped skill provider，不会在 Agent preset 中创建 agentSkills host 服务。

方式三：从 GitHub 安装

dsh plugin --profile web add github:minivv/dsh-agent-skills

仓库包含 prepare: npm run build，因此 pnpm 会在 Git 安装时自动构建。DSH/pnpm 可能会要求你授权构建脚本；不想授权构建时请使用 npm 或插件市场版本，npm 包已经包含构建好的 lib/。

使用

1. 打开 DSH Web。
2. 进入「设置 → Agent Skills」。
3. 检查自动发现的来源，或点击「+ 添加目录」。
4. 使用来源开关或技能开关控制 Agent 可见范围。
5. 修改磁盘上的技能后，点击「重新扫描」或等待自动刷新。

插件状态保存在：

$DSH_HOME/agent-skills/state.json

支持的目录结构：

skills/
├── my-skill/
│   └── SKILL.md
└── another-skill.md

SKILL.md 需要 YAML frontmatter，name 必须使用小写 kebab-case：

---
name: my-skill
description: Explain when this skill should be used.
---

# Instructions

卸载

如果安装过 preset-only 行，请先清理它，再卸载 npm 包：

DSH_INSTALL_ROOT="$(npm root -g)/@deepseek-ai/dsh" \
  node ~/.dsh/profiles/web/node_modules/dsh-agent-skills/scripts/uninstall-preset.mjs

dsh plugin --profile web remove dsh-agent-skills

最后重启 DSH Web。插件不会自动删除 $DSH_HOME/agent-skills/state.json，方便以后重装时保留设置。

开发

要求 Node.js 20+。

npm install
npm run typecheck
npm run build
npm pack --dry-run

• src/index.ts：host 入口，提供设置页 remote service 和全局 provider。
• src/preset.ts：preset-only 入口，只注册 scoped provider。
• src/client/：设置页 UI。
• src/scan.ts：技能目录扫描和 frontmatter 解析。
• lib/：已提交的构建产物，供 npm 和免构建安装使用。

已知约束

• DSH 技能名必须匹配 [a-z0-9]+(?:-[a-z0-9]+)*。
• 修改插件安装或 preset 组合后需要重启一次；技能启停和重新扫描不需要重启。
• DSH 升级可能覆盖其内置 preset 文件；如开关不再生效，重新运行 scripts/install-preset.mjs。

相关链接

• GitHub
• npm
• WeiSpot 项目页

License

MIT