Skills结构与渐进加载:先发现,再读取必要流程
Skills结构与渐进加载:先发现,再读取必要流程,从执行机制、错误边界与可运行例子理解工程取舍。
一个发票核对Skill可以保存操作步骤、字段规则和脚本,而工具只负责执行具体动作。Skill被加载不等于脚本已经运行;它让Agent获得执行方法,实际动作仍受工具能力、身份和权限限制。
目录中的文件分别解决什么
SKILL.md由元数据和正文组成。name提供标识,description说明用途与触发场景;正文说明步骤、判断条件和失败处理。scripts放适合确定性执行的程序,references保存按需查阅的细则,assets可放模板或其他静态资源。路径布局应让Agent容易找到实际需要的资料,而不是要求每次读全部历史文件。
元数据格式和名称限制以Agent Skills规范为准,具体宿主还可能有额外约束。可选allowed-tools字段的支持与语义取决于宿主实现,不应当成跨平台的安全沙箱。文件里写“允许访问任何目录”也不能覆盖用户或宿主授权规则。
渐进披露怎样节省上下文
发现阶段只提供技能名称与描述,判断相关后加载正文,执行到具体细则或脚本时才读取对应资源。这样大量技能可以被索引,而不把所有正文提前塞进上下文。前提是描述足够区分触发场景,正文能明确链接资源,资源路径真实存在。
渐进加载不是忽略必要上下文。若正文依赖一个规则文件却没告诉Agent何时读取,就可能漏步骤;若所有资源都被无条件引入,又失去节省意义。需要按任务依赖设计信息层次,关键安全前置条件不能藏到永远不会加载的附录里。
Skill、Prompt、工具与MCP的关系
Prompt是当前调用的指令或输入形式;Skill是可复用工作方法与资源包;工具提供可执行能力;MCP提供外部能力连接协议。一个Skill可以指引Agent调用MCP工具并运行本地脚本,但Skill本身没有自动网络权限,也不保证宿主一定支持所有引用方式。
脚本适合格式解析、计算、检查与重复操作,正文适合解释何时用、输入如何准备和失败怎样处理。不要把稳定算法写成大段让模型临场重算,也不要把需要业务判断的步骤隐藏在不可解释脚本里。
跟做:分别加载元数据、正文和规则
保存为skill_loading.py,运行python -X utf8 skill_loading.py。程序用字符串夹具模拟三阶段读取,不修改你机器上的真实Skill,不实现自动触发或脚本运行。
"""渐进披露:字符串夹具模拟加载层次,不读取真实skill。"""
SKILLS={'invoice-review':{'description':'核对发票字段与订单一致性','body':'先读取订单,再比较金额和抬头。资料不全返回缺项。','references':{'tax-rules':'固定测试规则:金额须与订单核对。'}}}
def load(name,level,reference=None):
skill=SKILLS[name]
if level=='metadata':return skill['description']
if level=='body':return skill['body']
if level=='reference':return skill['references'][reference]
raise ValueError('unknown_level')
if __name__=='__main__':
print('发现',load('invoice-review','metadata'))
print('触发后',load('invoice-review','body'))
print('需要规则时',load('invoice-review','reference','tax-rules'))
print('执行脚本数量',0)实际运行输出:
发现 核对发票字段与订单一致性
触发后 先读取订单,再比较金额和抬头。资料不全返回缺项。
需要规则时 固定测试规则:金额须与订单核对。
执行脚本数量 0第一步只看到用途,第二步获得操作流程,第三步在需要规则时读取引用;执行脚本数量仍为0。说明“加载”与“执行”是不同状态。把reference名称改为不存在的键会失败,实际宿主应给出明确路径错误,而不是凭空补写规则。
移植与维护
相对路径以Skill目录为基准,注明依赖环境、输入输出和支持范围。对资源版本和脚本变更做回归,避免正文仍描述旧参数。来自外部仓库的Skill需要审查脚本和访问行为,尤其安装依赖、网络发送与文件修改;技能说明是外部指令来源,不能自动提升权限。
综合追问:Skill被误触发,加载后还找不到脚本,分别修哪里?
这是给定条件下的机制推演;数值用于解释判断,不是新增线上或模型实测。先独立回答,再核对下面的推理。
展开推理、取舍与排错路径
SKILL.md元数据的name/description帮助发现,正文说明步骤,scripts提供可执行过程,references存按需规则,assets提供模板素材。先用元数据选相关技能,再读正文,最后读当前步骤需要的资源;可节省上下文,但必要前置条件若藏在从不加载的文件会导致遗漏,入口必须指向它。
“解释发票”被当“核对发票”执行,先收紧用途与触发边界,不用增加大段正文掩盖description问题。引用脚本缺失时核对相对路径和打包版本,停止依赖步骤并报告缺项,不能编造执行结果。allowed-tools是否限制真实权限取决于宿主,方法加载不等于动作授权。面试给出目录职责、三层加载和两个不同故障归因,同时说明资源变更要与正文版本一起回归。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
Skill与工具最重要区别?
参考思路与常见误区
Skill保存方法与资源,工具提供执行能力;加载方法不代表动作已经运行或获准。
常见误区:把Skill当自动执行API。
渐进披露分几层?
参考思路与常见误区
先元数据判断相关,再正文获取流程,最后按需读取资源或脚本;必要前置条件要可发现。
常见误区:每次加载所有资源。
description应写什么?
参考思路与常见误区
清晰描述用途和触发条件,区分相似技能与不适用任务,便于发现。
常见误区:只写高效专业等宣传语。
allowed-tools一定是沙箱吗?
参考思路与常见误区
不是通用保证,支持和执行语义依赖宿主,真实权限仍由运行环境控制。
常见误区:文件声明即系统授权。
引用文件缺失如何处理?
参考思路与常见误区
报告缺失路径并停止依赖它的步骤,不能编造规则;维护时验证正文与资源版本一致。
常见误区:按名称猜内容继续执行。
协议与接口细节请对照:官方资料1。