插件开发技能dsh-io/dsh-plugin-skill

创建-dsh-插件

一个用于为 DeepSeek Harness (dsh) 构建工具和插件的 agent 技能——官方插件 API、项目布局和工作流程，提炼自真实的 @deepseek-ai/dsh-tools 类型定义。以标准的 SKILL.md 格式编写，因此每个主流 AI 编码 agent 都能加载它。

如果你的 agent 曾经拒绝编写 dsh 插件（不熟悉的 API），或者自信地输出了错误的插件（用 run 而不是 execute、缺少 output、没有 inject），这个技能能同时解决这两个问题：它给 agent 提供可以逐字复制的权威签名。

安装

该技能是一个单独的 SKILL.md 文件夹。将它安装到你的 agent 读取的 skills 目录中。常见位置：

| Agent | 路径 |
|---|---|
| Claude Code | ~/.claude/skills/creating-dsh-plugins/ |
| Codex | ~/.codex/skills/creating-dsh-plugins/ 或 ~/.agents/skills/creating-dsh-plugins/ |
| Gemini CLI | ~/.agents/skills/creating-dsh-plugins/ |
| opencode | ~/.config/opencode/skills/creating-dsh-plugins/（或作为插件） |
| Cursor | ~/.cursor/skills/creating-dsh-plugins/ |
| superpowers（插件生态） | ~/.config/opencode/node_modules/superpowers/skills/creating-dsh-plugins/ |

一行安装命令：

mkdir -p ~/.claude/skills && \
git clone --depth 1 https://github.com/dsh-io/dsh-plugin-skill.git ~/.claude/skills/creating-dsh-plugins
将目标路径替换为你的 agent 对应的路径（见上表）；对于 Codex/Gemini 使用 ~/.agents/skills

对于单个项目，你也可以将该文件夹放入项目的 skills 目录（.claude/skills/、.cursor/skills/、……），这样只有该仓库的 agent 会加载它。

验证它是否生效

在你的 agent 中启动一个新会话并询问：

使用 creating-dsh-plugins 技能编写一个 dsh 插件，注册一个 get_weather 工具。

正确加载的技能会生成 src/index.ts，其中包含 inject = ['tools']、ctx.tools.register(defineTool({ ... output: { schema, render } ... })) 以及一个 execute(args) 方法——绝不是 run，也绝不是 required 数组。

内容

- SKILL.md —— 技能本身：工具 API 参考、硬性 schema 规则、项目布局、工作流程、常见错误、快速参考

内置的权威事实

- 工具通过来自 @deepseek-ai/dsh-tools 的 defineTool 注册；output（schema + render）是必需的
- required 是逐属性的（required: true）；没有 required 数组，也没有 required: false
- 对象 schema 上必须显式声明 additionalProperties
- 容器是 @deepseek-ai/cordis（一个 cordis 分支），不是 koishi
- pnpm 用户需要为未发布的上游 peer 依赖 @deepseek-ai/dsh-type-meta 添加 pnpm-workspace.yaml override
- 分发方式：npm publish + GitHub dsh-plugin topic

相关

- @dsh-io/dsh-dev —— 官方 dsh 插件工具链 CLI（scaffold、dev、check、publish）
- DeepSeek Harness —— 本技能所针对的 agent 框架

许可证

MIT © 2026 dsh-io