DeepSeek Harness 原生支持 <name>/SKILL.md,且 frontmatter 鍵名與 Anthropic 規範對齊。DSH 缺少的是導入、歸一化與分發工具鏈。dsh-skill-adapter 提供這套工具,把 agent-skills 等現有庫搬到 DSH。
本插件由 zp-home 維護,MIT 許可證。核心包含:零依賴解析庫、CLI 導入器、DSH SkillProvider 插件。
核心功能¶
該插件提供三部分能力:
- 解析與歸一化:
@dsh-skill-adapter/core。解析 SKILL.md(零依賴手寫 YAML 子集),歸一化 frontmatter。歸一化規則包括:name和description爲必需,非法name轉爲 kebab-case,when-to-use/when_to_use統一爲whenToUse。 - CLI 導入工具:
dsh-skill-import。支持批量抓取、校驗、歸一化、寫入磁盤,並生成兼容性報告。 - 運行時掛載:DSH 插件
SkillProvider。在運行時動態掛載 GitHub 或本地目錄的技能,無需手動複製文件。
安裝與啓用¶
安裝插件使用官方命令:
dsh plugin --profile web add github:<你的用戶名>/dsh-skill-adapter
安裝後,編輯已安裝包的 cordis.patch.yml,配置技能源。支持 GitHub 倉庫和本地目錄兩種類型:
- insert:
- id: dsh-skill-adapter
name: dsh-skill-adapter
config:
cacheTtlMs: 300000 # 列表緩存毫秒數(默認 5 分鐘)
sources:
- type: github
owner: addyosmani
repo: agent-skills
- type: local
root: /path/to/my/skills
重啓 dsh web 後,DSH 的 skill 工具即可發現這些技能。
CLI 導入器用法¶
若需一次性批量導入並寫入磁盤,使用 CLI 工具。命令位於 packages/cli/src/cli.js。
從 GitHub 技能庫導入:
node packages/cli/src/cli.js \
--source github:addyosmani/agent-skills \
--verbose
多源導入並預覽:
node packages/cli/src/cli.js \
--source github:ckorhonen/claude-skills \
--source local:./my-skills \
--out ~/.dsh/skills \
--dry-run --verbose
輸出 JSON 兼容性報告:
node packages/cli/src/cli.js --source local:./examples/skills --json
環境與依賴¶
- 需要 Node.js 版本 >= 18.17。
- 依賴
@deepseek-ai/cordis(可選依賴)。 - 若需被
dsh-recommendregistry 收錄,必須在 GitHub 倉庫打上話題dsh-plugin。
該插件填補了 DSH 生態中從 Claude Code/Codex 遷移技能的空白,提供了從解析到分發的一站式方案。