同一句需求,交给两个 agent,会以两种方式失败。
一个说:「我没有这个工具。」——它缺的是插件。
另一个工具齐全,却把顺序做反、把参数填错、把该核验的步骤跳过——它缺的是技能。
插件改运行时,技能改上下文。前者给 agent 装手,后者给它装一张流程图。混为一谈,通常会长出两种东西:能跑但没人会用的插件,和写得很全却永远触发不了的技能。

一、插件:往运行时里装器官
插件是一个 npm 包。DSH 启动时按 profile 里的 dsh.profile.bundles 组装一棵 cordis 加载树,插件就是树上的节点,随运行时一起初始化。
它最核心的动作是注册工具。以本站配图用的 dsh-image-gen 为例,源码里就是一行 ctx.tools.register(defineTool({ name: "generate_image", ... }))。这行执行完,模型面前就多了一个可以调用的函数。同理,dsh-builtin-browser 带来整套 browser_*,billion-context 带来 compress 与 decompress,dsh-univer-office 带来 univer_*。
插件还能挂前端面板、开后台服务、监听事件、加配置项。代价是它每轮都在场:工具的名字、说明、参数 schema 会常驻系统提示,不管这一轮用不用得上。
装一个插件,意味着改依赖、改加载树、重载 profile。它绑定 DSH 的 API 版本,跨不过 engines.dsh 那道门。
二、技能:往上下文里塞说明书
技能只是一个目录,里面一个 SKILL.md。开头是 YAML frontmatter——name 和 description,正文是流程、规范、判据、踩过的坑。
关键在加载方式:系统提示里只放 skill 的目录(名字加一句描述),正文不进来。直到任务命中,模型调用 skill 工具,正文才被读进上下文。这叫渐进披露。
技能不执行任何代码。它教模型用已有的工具——pwsh、浏览器、HTTP 请求、生图——把事情按某个顺序做完。它也不锁平台:同一份 SKILL.md,Claude Code、Codex、Cursor、Copilot 都能读。本机 ~/.agents/skills 下两百多个目录,从文章配图到 Halo 发布,从期权链入库到 C 盘清理,每个都只是一份说明书。

三、六个维度看差别
| 维度 | 插件 | 技能 |
|---|---|---|
| 本质 | 可执行的 npm 包 | Markdown 指令包 |
| 进入哪里 | 运行时,cordis 加载树 | 上下文,目录常驻、正文按需 |
| 怎么装 | dsh plugin add,改 profile bundles,重载 | 把目录拷进技能根,下一轮就出现在目录 |
| 上下文成本 | 工具 schema 每轮常驻 | 只有名字和描述,正文用到才读 |
| 能力边界 | 抬高上限,能做原本做不到的事 | 不新增能力,只改做法 |
| 可移植性 | 绑 DSH 与版本 | 跨 agent 通用 |
| 风险 | 任意代码,权限大 | 文本注入,最坏是不听话 |
四、本文就是一次证据链
这篇文章的配图由 generate_image 生成——那是插件注册的工具;图片上传到 Cloudflare R2 的 wychatop 桶,走的是 Halo 的 r2-wycha 存储策略;文章最后发到本站「技术杂谈」,依据的是 halo-pat-admin 技能里那张端点表和十三条坑。
三个角色分得很清楚:插件提供原子能力(生成一张图),技能提供编排与判据(先查分类 ID、正文必须是 HTML、上传不能手写 Content-Type、发完要用前台状态码自检),模型负责执行。
还有两个容易忽略的事实:管理技能的界面,本身是一个插件;而 dsh-image-gen 包里,又自带了一个 SKILL.md 教人怎么安装它。两层互相嵌套,恰好说明它们不是互斥的两个分类,而是两个正交的层。
一句话:工具由插件给,方法由技能教。插件让 agent 做得到,技能让它做得对。
五、为什么非要分两层
- 上下文预算。一百个技能,系统提示里只多一百行描述;一百个工具,会把上下文撑到没法用。常驻的东西必须少而硬,按需的东西才能多而软。
- 权限边界。插件是代码,能读文件、发请求、起进程;技能是文本,最坏的结果只是模型不听话。两者风险差一个量级,安装时的审核强度也该差一个量级。
- 可移植性。SKILL.md 已经是跨 agent 的事实标准,插件永远绑在某个 runtime 的 API 上。一个团队真正想沉淀的方法论,应该放在可移植的那一层。
- 演进速度。技能改一行 Markdown 就生效;插件要发版、过版本门控、重载、回归。越靠近「判断」的东西变化越快,就越该放在轻的那一层。
六、怎么判断该写哪个
四个问题,按顺序问:
- 现有工具能不能完成这件事?能,就写技能。
- 需要一个新的系统调用、新 API、新界面?才写插件。
- 步骤是否稳定、有没有明确判据和已知的坑?有,才值得写成技能。
- 要不要在别的 agent 里复用?要,就只能写技能。
两种常见反模式:把一条流程硬塞进插件——过度工程,升级一次就碎;把需要新能力的任务写成技能——模型只能靠猜和演,产出看着像样,实则是幻觉。
正确姿势是组合:插件给窄而稳的原子工具,技能给宽而软的编排与判据。插件越少越好,技能越具体越好。

七、尾声
插件决定一个 agent 能做到什么,技能决定它做得像一个生手还是一个熟手。
能力可以买,判断只能攒。分不清这两层的人,往往把时间花在造工具上,而不是把事做完。
评论区