本文通过一个实际场景,详细讲解了如何使用 Skill.md 规定查询步骤,并通过 MCP 客户端调用工具,校验返回数据,实现 Agent 自动化生成日报。文章从连接工具、明确工具契约、编写 Skill 指令到核对执行结果,最后通过四次检查确保接入完成,帮助程序员快速掌握大模型实战技巧。
一个示例场景:运营同事想让 Agent 查询指定店铺某一天的订单,并生成简短日报。开发者在 SKILL.md 里写好“查询订单、统计金额、输出摘要”,运行时却发现 Agent 只给出了一份空白模板。团队已经有订单接口,但当前会话看不到查询工具,而且这项任务只允许读取数据,不能修改订单。
图注:沿蓝色路径看请求如何发出,再沿绿色路径看数据如何返回。Skill 规定步骤,宿主执行调用;返回通过范围、字段和完整性校验后,才进入正式日报。
Skill 调用 MCP 的关键,是用 Skill 规定查询步骤,再由 Agent 所在的宿主通过 MCP 客户端实际调用工具,并校验返回的数据是否足以完成任务。
- 先找准断点:写了步骤,不等于接通工具
这里的 Skill,可以理解为供 Agent 使用的任务说明包,通常包含指令,也可以附带脚本等文件。它比一次聊天指令更便于重复使用,但 SKILL.md 本身不会自动建立外部连接。示例中的失败,就发生在“知道该查询什么”和“拥有可执行的查询入口”之间。
MCP,即模型上下文协议,规定了应用如何与服务端交换工具、资源等信息。它与订单 HTTP API 的区别在于:订单 API 面向具体业务,MCP 提供一套让宿主发现和调用这些能力的统一交互方式;订单系统仍然需要服务端去适配。本文只走 MCP 工具这一条路径,通过查询工具同时取得业务数据。
宿主是运行 Agent 的应用,它管理模型会话和工具执行,并通过内置或集成的 MCP 客户端连接服务端。典型链路是:宿主加载 Skill,Agent 根据指令提出工具调用,宿主经客户端发给 MCP 服务端,服务端查询订单系统,再把结果沿原路返回。这样就能分别检查:指令有没有加载、工具有没有暴露、请求有没有执行、结果有没有通过校验。
- 先在宿主接通一次查询
继续编写日报步骤之前,应先让宿主能够发现订单查询工具。具体配置格式取决于使用的应用:本地服务通常需要启动命令,远程服务需要连接地址及对应认证配置。把服务地址写进 SKILL.md,并不意味着宿主已经完成这些配置。
本例假设团队提供了一个适配订单系统的 MCP 服务端,仅暴露只读查询能力。连接凭证交给宿主支持的认证或配置机制管理,Skill 只描述依赖哪个工具,不承担保存密钥的职责。如果服务端尚未实现订单查询,首先需要补上这一层适配。
连接后,检查宿主可用工具列表,并执行一次已知店铺和日期的查询。MCP 的tools/list用于列出工具,tools/call用于调用工具,用户界面未必直接展示这些协议方法。这个阶段的可见产物应是“一次有参数、有返回的查询记录”,仅显示“服务器已连接”还不足以继续。
- 把查询需求变成明确的工具契约
下面约定一个示例工具query_daily_orders,名称和字段均用于说明,不代表任何平台内置能力。实际接入时,应以宿主展示的工具名称、输入 Schema 和服务端约定为准;宿主也可能为工具名称添加前缀。
| 契约部分 | 本例约定 |
|---|---|
| 输入 | store_id、date、timezone |
| 查询范围 | 按指定时区,统计该日期内支付成功的订单 |
| 返回内容 | 店铺、日期、时区、币种、订单数、支付金额、complete |
| 完整性含义 | complete表示该查询范围是否已完整统计 |
| 金额口径 | 支付金额,不直接称为净收入 |
这一步的作用,是消除“查当天订单”里的歧义。订单日期可能按创建时间,也可能按支付时间计算;如果工具采用支付时间,Skill 就必须使用同一口径。币种和退款处理方式也需要明确,否则即使调用成功,日报仍可能解释错误。
本例选择由服务端聚合全天数据,并返回完整性标记,让 Skill 负责检查和表述结果。如果现有工具只返回分页明细,就要先明确如何读取后续页,以及何时算读取完整,不能把第一页当作全天订单。此时的中间产物是一份可核对的输入、输出约定,而不是一句模糊的“使用订单工具”。
- 在 Skill 里写清调用条件与结果处理
工具可用后,再把契约落实到 Skill 指令中。下面是一段可复制的正文模板,适合放入已有的 SKILL.md;文件头部元数据和安装位置按宿主要求填写。模板里的工具名必须替换成当前会话实际可调用的名称。
任务:查询单个店铺指定日期的订单,生成只读日报。 依赖: - MCP 工具 query_daily_orders。 - 工具入参:store_id、date、timezone。 - 返回应包含查询范围、币种、订单数、支付金额和 complete。 执行: 1. **检查店铺、日期、时区是否齐全;缺失时请用户补充。** 2. **若当前会话无法使用依赖工具,停止并说明缺少的能力。** 3. **使用确认后的三个参数调用工具。** 4. **检查是否调用成功,以及返回范围是否与请求一致。** 5. **检查 complete 是否为 true,必要字段是否齐全。** 6. **通过检查后输出查询范围、订单数、支付金额和币种。** 边界: - 不执行任何修改订单的操作。 - 查询失败或数据不完整时,不输出正式日报。 - 完整查询返回订单数为 0 时,才报告零订单。 - 不将支付金额改写为净收入,不推测缺失数值。这里既规定了何时调用,也规定了拿到返回以后能说什么。尤其要区分“查询成功但没有订单”和“没有拿到订单数据”:前者可以生成零订单日报,后者只能报告执行状态。
Skill 中的指令用于引导 Agent 行为,不能替代服务端实际的权限限制。如果任务要求只读,连接账户和工具本身也应只提供相应能力;这样,示例中“不修改订单”的限制才同时落实在执行层。
- 沿同一条链路核对执行结果
准备好 Skill 后,用一个明确请求测试,例如“查询店铺 S001 在 2026-09-18、Asia/Shanghai 时区的订单日报”。先看宿主是否加载了 Skill,再看工具调用记录中的三个参数是否一致。最终回答看起来像日报,不能证明外部查询真正发生过。
假设示例工具返回的范围与请求一致,包含币种、订单数和支付金额,且complete为真,Agent 才具备生成正式日报的条件。若返回范围正确但完整性标记为假,本次任务应停在“数据不完整”,不能把已有数字包装成全天结果。这里展示的是预期执行分支,不是某个平台的实测成绩。
定位失败时,可以按照已经取得的中间产物逐层缩小范围。宿主找不到工具,先查连接和工具暴露;参数被拒绝,核对 Schema;调用成功却无法成文,检查返回字段与统计口径。每次只修正出错的一层,更容易判断修改是否有效。
- 用四次检查决定是否完成接入
首次接入适合从本例这样的单工具、只读查询开始,先验证外部能力能否被 Skill 正确使用。正常路径跑通后,再验证缺参和失败分支,避免只凭一次顺利演示就判断接入完成。
- 正常输入:提供完整参数,确认调用记录、返回范围和日报数字一致。
- 缺少日期:确认 Agent 要求补充,不自行猜测查询时间。
- 零订单与数据不完整:分别测试,确认前者正常报告,后者停止出具全天统计。
图注:按行执行四次检查,按列核对输入、证据与下一步。零订单只有在完整查询后才可出报;遇到失败就回到对应层修正,再重测该项。
四项均符合预期,才算完成本文范围内的接入:宿主能调用,Skill 能按契约使用,结果能验证,失败能停止。若卡在任何一项,就回到对应的连接、工具契约或指令层修正,再重复该项检查;这比继续增加日报措辞,更能解决“Skill 写好了,却拿不到可用数据”的问题。
如何学习大模型 AI ?
由于新岗位的生产效率,要优于被取代岗位的生产效率,所以实际上整个社会的生产效率是提升的。
但是具体到个人,只能说是:
“最先掌握AI的人,将会比较晚掌握AI的人有竞争优势”。
这句话,放在计算机、互联网、移动互联网的开局时期,都是一样的道理。
我在一线科技企业深耕十二载,见证过太多因技术卡位而跃迁的案例。那些率先拥抱 AI 的同事,早已在效率与薪资上形成代际优势,我意识到有很多经验和知识值得分享给大家,也可以通过我们的能力和经验解答大家在大模型的学习中的很多困惑。我们整理出这套AI 大模型突围资料包:
- ✅ 从零到一的 AI 学习路径图
- ✅ 大模型调优实战手册(附医疗/金融等大厂真实案例)
- ✅ 百度/阿里专家闭门录播课
- ✅ 大模型当下最新行业报告
- ✅ 真实大厂面试真题
- ✅ 2026 最新岗位需求图谱
所有资料 ⚡️ ,朋友们如果有需要《AI大模型入门+进阶学习资源包》,下方扫码获取~
① 全套AI大模型应用开发视频教程
(包含提示工程、RAG、LangChain、Agent、模型微调与部署、DeepSeek等技术点)
② 大模型系统化学习路线
作为学习AI大模型技术的新手,方向至关重要。 正确的学习路线可以为你节省时间,少走弯路;方向不对,努力白费。这里我给大家准备了一份最科学最系统的学习成长路线图和学习规划,带你从零基础入门到精通!
③ 大模型学习书籍&文档
学习AI大模型离不开书籍文档,我精选了一系列大模型技术的书籍和学习文档(电子版),它们由领域内的顶尖专家撰写,内容全面、深入、详尽,为你学习大模型提供坚实的理论基础。
④ AI大模型最新行业报告
2025最新行业报告,针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估,以了解哪些行业更适合引入大模型的技术和应用,以及在哪些方面可以发挥大模型的优势。
⑤ 大模型项目实战&配套源码
学以致用,在项目实战中检验和巩固你所学到的知识,同时为你找工作就业和职业发展打下坚实的基础。
⑥ 大模型大厂面试真题
面试不仅是技术的较量,更需要充分的准备。在你已经掌握了大模型技术之后,就需要开始准备面试,我精心整理了一份大模型面试题库,涵盖当前面试中可能遇到的各种技术问题,让你在面试中游刃有余。
以上资料如何领取?
为什么大家都在学大模型?
最近科技巨头英特尔宣布裁员2万人,传统岗位不断缩减,但AI相关技术岗疯狂扩招,有3-5年经验,大厂薪资就能给到50K*20薪!
不出1年,“有AI项目经验”将成为投递简历的门槛。
风口之下,与其像“温水煮青蛙”一样坐等被行业淘汰,不如先人一步,掌握AI大模型原理+应用技术+项目实操经验,“顺风”翻盘!
这些资料真的有用吗?
这份资料由我和鲁为民博士(北京清华大学学士和美国加州理工学院博士)共同整理,现任上海殷泊信息科技CEO,其创立的MoPaaS云平台获Forrester全球’强劲表现者’认证,服务航天科工、国家电网等1000+企业,以第一作者在IEEE Transactions发表论文50+篇,获NASA JPL火星探测系统强化学习专利等35项中美专利。本套AI大模型课程由清华大学-加州理工双料博士、吴文俊人工智能奖得主鲁为民教授领衔研发。
资料内容涵盖了从入门到进阶的各类视频教程和实战项目,无论你是小白还是有些技术基础的技术人员,这份资料都绝对能帮助你提升薪资待遇,转行大模型岗位。