黄胜泽研究与实践
← 全部技术笔记

FIELD NOTES · 2026.10.26

MCP、Tool、Skill、CLI:从一次真实任务拆开四个概念

同一个“查文档、整理结论、写回飞书”的任务,可以经过不同的调用路径。把执行动作、连接协议、操作入口与任务方法分开,就更容易判断该接什么、该学什么,以及出错时该改哪里。

这是 2026.10.26 的研究记录,保留当时的问题和结果。

为什么装好了,Agent还是不会用

看一个工具项目时,我最想问的是:它到底把什么交给了Agent?是一个可以执行的动作,一套动作的接入方式,一份做事方法,还是一个能够在终端里运行的程序?这几个东西经常被放在同一页介绍,安装命令也都很短,实际解决的问题却不同。

以整理技术资料并写入飞书为例,读文档与创建文档是动作,如何按主题消化材料是方法,怎样连接到飞书能力是接入,终端命令是另一种操作入口。我们可以把它们组合起来,但不能因为其中一个已经存在,就假设其余环节已经完成。

Tool是动作,MCP约定怎样连接

Tool是Agent可调用的能力,通常有名称、输入参数与返回结果。它可以是本地函数、远程接口或一段程序的包装;并非所有Tool都经过MCP。看工具时要看具体动作,例如搜索哪些文档、返回完整内容还是摘要、写入后返回什么标识。

Model Context Protocol,即MCP,约定宿主、客户端与服务器如何交换能力与数据。工具发现和调用只是其中一部分,协议还包含资源、提示等能力。MCP服务器能够暴露多个Tool;真正执行动作的可能是服务器内部代码,也可能是它调用的外部服务。具体连接关系可参照MCP官方架构说明。

因此,“支持MCP”能说明存在一种接入路径,却不能说明工具覆盖了全部业务,也不能说明当前客户端已完成授权、发现并调用了这些工具。判断时继续往下看实际工具名与回执,比只看协议标签更有帮助。

CLI是程序入口,Skill描述怎样把能力用起来

Command Line Interface,即CLI,是命令行接口。人和Agent都可以调用它,参数、输出与退出状态共同构成操作契约。Agent可以通过终端工具执行CLI;MCP服务器也可以在内部调用CLI,但这些都只是可能的实现方式,没有固定依赖顺序。

Agent Skill是一种可发现、按需加载的能力包。常见结构以SKILL.md描述适用场景和步骤,并附带参考资料、模板或脚本。Skill可以教Agent调用CLI,也可以组织MCP工具,甚至只指导本地文件处理。文件结构与渐进加载机制以Agent Skills规范为准。

关键区别是职责。Skill里的“先检索再整理”描述工作方法;实际检索还需要执行入口和数据来源。反过来,工具接好了,模型也未必知道什么情况下该用它,或怎样组合调用。客户端的发现、加载和执行机制决定这些部分能否接起来。

同一项飞书任务,可以走两条路

第一条路:宿主发现飞书MCP工具,模型选择搜索与读取动作,整理材料后调用文档写入工具。第二条路:加载飞书相关Skill,模型按说明通过终端执行lark-cli,用命令完成对应操作。两条路都可能访问飞书开放平台,但它们的调用格式、身份处理和失败反馈不一定相同。

飞书分别提供官方OpenAPI MCP与官方CLI及配套Skills。CLI里又区分快捷命令、平台API命令和原始API入口。对学习者来说,这是一个很适合看清“任务方法”和“执行接口”如何配合的实例。

假设创建文档失败,先看断在哪里:模型有没有选中工具,参数是否匹配当前接口,调用身份是否能访问目标,服务是否返回有效结果。若文档写成了但结构混乱,优先改方法、模板或排版;若根本没找到目标文档,继续调整文风就解决不了问题。这个例子是调用路径解释,不是本次对两条路径做出的性能评测。

Plugin也要看语境

有的产品把MCP、Skills和Hooks打包分发,称为Plugin。DSH研究里说的插件,则是挂到运行生命周期、改变状态或行为的代码组件。两者都叫插件,能力边界却取决于宿主。不能把某个产品的插件安装包,直接等同于我们实验里可进化的所有修改面。

同样,MCP也可以承载Skill的发现与分发;这并不会让两者职责变成一样。比画一条“Skill必须经过MCP再调用CLI”的固定链条更准确的办法,是沿一次任务逐跳记录:谁提供方法、谁决定调用、谁执行动作、谁返回结果。

我的学习顺序:先完成一件事,再抽象成方法

我会先选择一个具体且可观察的任务,读清所需接口,跑通单次执行,再把经常重复的步骤整理成Skill。需要接入多个宿主或服务时,再比较MCP带来的连接与管理价值。这个顺序能避免一开始安装很多包,却不知道它们各自帮了什么。

完成的标志也很朴素:任务所需的结果真实存在,Agent知道它来自哪次调用,失败时能够定位到具体环节。进一步比较效率与可靠性时,再固定任务、身份和数据条件。接下来的中国科技公司工具地图,就按这个思路整理官方入口。