Skill 进阶：用 references 目录打造 Skill 的第二大脑

你好，我是C哥。

我们在编写 Skill 的时候，经常会遇到一个两难的问题：Agent 需要知道很多背景知识才能把活干好，但如果把这些知识全都写进核心指令文件 SKILL.md，文件就会变得又长又乱，维护起来极其痛苦。

举个例子，你想写一个智能客服 Skill，用来回答客户关于公司产品的各种问题。如果把几百个产品的规格、价格、保修条款全都写在 SKILL.md 里，这个文件不仅会臃肿不堪，而且每次产品调价、政策更新，你都得去改核心代码。这显然不是一个优雅的架构。

怎么解决这个问题？答案是：把指令和知识分开。

在 Skill 文件夹中，有一个非常重要的扩展目录，叫做 references。它就是 Skill 的知识库，或者说是 Agent 执行任务时的第二大脑。

什么是 references 目录？

references 是 Skill 文件夹下的一个子目录，专门用来存放 Agent 执行任务时需要查阅的参考资料、背景知识和规范标准。

这就好比你刚入职一家公司，HR 给了你一份岗位职责说明书（相当于 SKILL.md），告诉你每天要干什么。但具体怎么干、公司的规章制度是什么、产品的详细参数在哪里查，这些信息通常都在公司的知识库或者员工手册里（相当于 references 目录）。

实战：打造一个外贸询价助手

让我们通过一个具体的场景来看看 references 目录怎么用。