当前位置：首页 > news >正文

AgentSkill IS “AI领域的Docerfile“

news 2026/8/22 17:42:17

什么是Agent Skill

Agent Skill成为AI Agent领域的一个通用设计模式。

简单来说就是大模型可以随时翻阅的说明文档

Agent Skill的基本用法

一开始，claude code会把所有Agent Skill的元信息（名称和描述）都给到模型，比如说爆款文案Skill、会议总结Skill、数据分析Skill等等，大模型会从中选择一个，之后只有选中的那个skill的SKILL.md文件才会给到模型，也就是按需加载，这样就可以非常省Token了。

Skill内容

--- name: 会议总结助手 description: 该技能用于根据会议录音总结内容 --- # 会议总结助手 ## 总结规则 请将会议内容总结为以下几点： - 参会人员 - 议题 - 决定 注意：每项都只能分别使用一句话来表述，不要分成多条。 ## 示例 输入： 张三：那我们开始吧，今天主要是把下个月社区志愿活动的安排一次性定下来。 李四：我建议活动放在公园，人多也方便组织。 王五：可以，不过要提前申请场地，不然可能有风险。 赵六：场地申请我可以负责，这周内给大家结果。 孙七：人数最好先有个范围，方便准备物资。 张三：那就先按50人左右来估算吧。 李四：上次的手套还能用，但垃圾袋需要再买。 王五：预算要不要设个上线，避免超值。 张三：预算控制在1000以内，优先用现有物资。 孙七：时间我建议周六上午，天气也不会太热。 李四：九点集合应该比较合适。 赵六：我周三前把申请结果同步到群里。 张三：好，那报名截止时间定在周四晚上。 王五：周五可以统一分组和采购。 孙七：我来负责写报名文案和活动当天的合影安排。 张三：安全方面提醒大家带水，活动结束简单总结一下就行。 张三：那今天就到这，大家分工推进。 输出： - 参会人员：张三、李四、王五、赵六、孙七 - 议题：统一确定下个月社区志愿活动的地点、时间、人数、预算及分工安排 - 决定：互动定在公园并与周六上午九点举行，按约50人规模和1000预算执行，由赵六负责场地申请、孙七负责宣传及合影，其余成员配合物资和分组。

Agent SKill的高级用法，Reference概念

下面新添加的财务提醒，就是Reference

财务提醒：仅在提到"钱、预算、采购、费用"时触发。需读取集团财务手册.md，指出决定中的金额是否超标，并明确审批人。

--- name: 会议总结助手 description: 该技能用于根据会议录音总结内容 --- # 会议总结助手 ## 总结规则 请将会议内容总结为以下几点： - 参会人员 - 议题 - 决定 - 财务提醒：仅在提到"钱、预算、采购、费用"时触发。需读取`集团财务手册.md`，指出决定中的金额是否超标，并明确审批人。 注意：每项都只能分别使用一句话来表述，不要分成多条。 ## 示例 输入： 张三：那我们开始吧，今天主要是把下个月社区志愿活动的安排一次性定下来。 李四：我建议活动放在公园，人多也方便组织。 王五：可以，不过要提前申请场地，不然可能有风险。 赵六：场地申请我可以负责，这周内给大家结果。 孙七：人数最好先有个范围，方便准备物资。 张三：那就先按50人左右来估算吧。 李四：上次的手套还能用，但垃圾袋需要再买。 王五：预算要不要设个上线，避免超值。 张三：预算控制在1000以内，优先用现有物资。 孙七：时间我建议周六上午，天气也不会太热。 李四：九点集合应该比较合适。 赵六：我周三前把申请结果同步到群里。 张三：好，那报名截止时间定在周四晚上。 王五：周五可以统一分组和采购。 孙七：我来负责写报名文案和活动当天的合影安排。 张三：安全方面提醒大家带水，活动结束简单总结一下就行。 张三：那今天就到这，大家分工推进。 输出： - 参会人员：张三、李四、王五、赵六、孙七 - 议题：统一确定下个月社区志愿活动的地点、时间、人数、预算及分工安排 - 决定：互动定在公园并与周六上午九点举行，按约50人规模和1000预算执行，由赵六负责场地申请、孙七负责宣传及合影，其余成员配合物资和分组。

Agent Skill的高级用法，Script篇

upload.py文件

importsysimporttimedefupload_summary(content):print("\n[System] 启动上传程序...")time.sleep(0.5)print("[System] 正在连接公司内部服务器（https://api.internal.wiki）...")time.sleep(1.2)# 模拟数据处理print(f"[System] 正在上传总结内容（字符数：{len(content)}）...")time.sleep(1.0)print("-"*100)print("√ 上传成功！")print(f"文档已保存至：/meetings/2024/summary_{int(time.time())}.md")print("预览连接：https://wiki.internal.com/view/99281")print("-"*100)if__name__=='__main__':iflen(sys.argv)>1:summary_text=sys.argv[1]upload_summary(summary_text)else:print("×错误：未收到总结内容")

SKILL.md文件

--- name: 会议总结助手 description: 该技能用于根据会议录音总结内容 --- # 会议总结助手 ## 总结规则 请将会议内容总结为以下几点： - 参会人员 - 议题 - 决定 - 财务提醒：仅在提到"钱、预算、采购、费用"时触发。需读取`集团财务手册.md`，指出决定中的金额是否超标，并明确审批人。 注意：每项都只能分别使用一句话来表述，不要分成多条。 ## 上传规则 如果用户提到"上传"、"同步"或"发送服务器"，你必须运行 upload.py 脚本，将总结内容上传到服务器。脚本使用方法： ```bash python upload.py "会议总结内容" ``` ## 示例 输入： 张三：那我们开始吧，今天主要是把下个月社区志愿活动的安排一次性定下来。 李四：我建议活动放在公园，人多也方便组织。 王五：可以，不过要提前申请场地，不然可能有风险。 赵六：场地申请我可以负责，这周内给大家结果。 孙七：人数最好先有个范围，方便准备物资。 张三：那就先按50人左右来估算吧。 李四：上次的手套还能用，但垃圾袋需要再买。 王五：预算要不要设个上线，避免超值。 张三：预算控制在1000以内，优先用现有物资。 孙七：时间我建议周六上午，天气也不会太热。 李四：九点集合应该比较合适。 赵六：我周三前把申请结果同步到群里。 张三：好，那报名截止时间定在周四晚上。 王五：周五可以统一分组和采购。 孙七：我来负责写报名文案和活动当天的合影安排。 张三：安全方面提醒大家带水，活动结束简单总结一下就行。 张三：那今天就到这，大家分工推进。 输出： - 参会人员：张三、李四、王五、赵六、孙七 - 议题：统一确定下个月社区志愿活动的地点、时间、人数、预算及分工安排 - 决定：互动定在公园并与周六上午九点举行，按约50人规模和1000预算执行，由赵六负责场地申请、孙七负责宣传及合影，其余成员配合物资和分组。

注意：Agent Skill里面的upload.py代码只会被执行，不会被读取，这就意味着哪怕脚本写了一万行复杂的业务逻辑，它消耗的模型上下文也几乎是零。claude code只关心脚本的运行方法和运行结果，至于脚本的内容，它不关心。

Reference和Script的区别

相同点：Reference和Script都属于Agent Skill的高级功能

但是他们对于模型上下文的影响是截然不同的

Reference：是读，它会把内容加载到上下文里面，所以是会消耗Token的

Script: 是跑，它只会被执行，不会占用模型的上下文

渐进式披露机制

Agent Skill的设计其实是一个精密的渐进式披露解构，这个解构里面一共有三层，每一层的加载机制都不太一样

第一层：元数据层，始终加载，这里有所有Agent Skills的名称和描述，他们是始终加载的，相当于大模型里面的目录，大模型每次回答前都会看一下这一层的信息，然后决定用户的问题是否与某个Agent Skill相匹配
第二层：指令层，按需加载，Skill.md中除名称和描述之外的内容
第三层：资源层，按需中的按需加载，包含Reference和Script两方面的内容，Reference和Script的加载方式其实不太一样，Reference是被读取的，claude code会把对应的内容放到模型的上下文中，供回答时参考；而Script是被执行的，claude code根本不会去看代码的内容，只关心执行代码的结果，如果你没有把代码的执行方法说清楚， claude code还是有可能回去看一下代码的，毕竟跑不下去了嘛，这样的话就会占用模型的上下文，所以在写Skill的时候，尽可能把一切都解释清楚。