AI编程工具-Agent Skill

Agent Skill 起初是Claude中一个小的功能模块，最近，越来越多的人觉得 Skills 非常的好用。所以 Codex、Cursor、Opencode 等 AI 编程工具，陆续加入了对 Agent Skills 的支持。2025年12月18日，Anthropic 正式把 Agent Skills 发布成了开放标准。https://agentskills.io/specification

本期将在Claude Code中配置Skills，看看如何使用它。

1.安装Claude Code

我的环境：windows 11, nodejs v20.19.5

在 PowerShell 中使用npm全局安装Claude Code，命令如下:

npminstall-g @anthropic-ai/claude-code

安装完毕后，在 PowerShell中执行claude就可以启动Claude Code, 此时会出现下面问题：

因为Claude 拒绝中国地区的访问，接下来我们只需要将默认使用的模型替换掉即可。

2.替换默认模型

Claude Code 运行的时候，是通过读取环境变量来更改接入大模型的。使用npm 命令安装完Claude Code后，会在用户Home目录中生成一个.clude文件夹，路径是 :C:\Users\{你的windows用户}\.claude,在这个文件夹中创建一个settinigs.json配置文件，这里使用的是glm-4.7模型：

{"env":{"ANTHROPIC_DEFAULT_HAIKU_MODEL":"glm-4.5-air","ANTHROPIC_DEFAULT_SONNET_MODEL":"glm-4.7","ANTHROPIC_DEFAULT_OPUS_MODEL":"glm-4.7"}}

配置环境变量:

ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL

ANTHROPIC_AUTH_TOKEN：你的API KEY

ANTHROPIC_BASE_URL：https://open.bigmodel.cn/api/anthropic

重新启动Claude

3.Agent Skill是什么？

简单理解就是带目录的说明书，说明书中的内容可以按需加载到上下文，最大好处是大幅降低了 token 消耗与提示词的复杂度。

Skills 把提示词分成了三层：元数据、指令，还有资源：

AI 使用 Skills 的时候，只是先把目录加载进提示词，然后根据需要，再决定是否查阅正文与附件。这样比起传统的 Prompt 或者 MCP 的方式，Agent Skills 的最大好处是大幅降低了 token 消耗与提示词的复杂度。

4.Agent Skill 基本用法

4.1 Agent Skill 目录结构

在项目目录下有一个.claude/skills目录,这个目录里面可以存放很多个 skill, 每个 Skill 就是一个文件夹，每个 Skill 都应该至少包含一个SKILL.md的定义文件。定义文件里面存放的是 Skill 的元数据层与指令层的内容。在 Skill 的这个文件夹里面，还可以放入其他类型的辅助文件，这些文件就是 Skill 的资源层。

4.2 SKILL.md文件

编辑SKILL.md文件.

首先是元数据部分(Metadata)，元数据以---(三个)开始，---(三个)结束。其中 name 必须与文件夹名称相同

接下来是指令(Instruction)部分，这个部分要详细一点，这里用 markdown 格式把指令中的重点都标记出来。

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

4.3 测试 Skill

打开 Claude 工具,切换到项目目录下：

输入：“你有哪些Agent Skill?”

输出:

● 根据我的技能配置，目前我有以下可用的Agent Skill： - 会议总结助手: 根据会议录音总结会议内容 你可以通过在命令前加上 / 来调用这些技能，例如使用 /会议总结助手 来启动会议总结功能。 需要了解某个技能的详细用法吗？

输入：请将下面的会议内容进行总结: （上面的例子粘贴到对话框：）

输出：

上面就是Agent Skill 的基本用法了。

4.4 工作流程

可以看到，用户发送内容后，Claude Code 只是将用户请求内容和SKILL.md文件中的Skill列表发送给了大模型，大模型经过思考后，决定选择一个叫做会议总结助手的 Skill 来完成这个任务，于是它告诉了 Claude Code 它的决定。

Claude Code 读取SKILL.md文件全部内容：（因为元数据是每次都要发送给大模型的）以及先前用户提交的问题一起交给大模型，大模型经过思考给出结果，进而Claude Code将结果交给用户。

Agent Skill 的第一个核心机制：按需加载
虽然Skill的名字和描述对大模型是始终可见的，但是具体的指令内容只有在这个Skill 被大模型选中后才会加载进来给大模型看，这样可以节省很多Token

5.高级用法-Reference

大模型根据Skill的指令来工作，简单的指令没有任何问题。但是如果希望大模型能判断出来会议内容中提高用钱的时候，能判断出来是否符合财务规定。有些会议决定是否有法律风险，要提示给用户。这样的话需要将财务规定，法务规定等规章制度"嵌入"到指令中，这样的话指令就会很臃肿，很浪费模型。

reference就是按需加载中的按需加载。即当会议内容中提到了“钱” 的时候，才加载财务规定。

新建一个集团财务手册.md文件，这个文件要放在你定义的 “会议总结助手” 下，为了清晰，我们将它放到references文件夹中：

内容如下：

# 集团财务手册 本手册详细规定了公司各部门在日常办公、差旅及商务活动中的支出限额与审批流程， ## 第一章:办公设备采购(IT Assets) 1. **更换周期**: 笔记本电脑、是示器笔固定资产的最任使用年限为3年， 2. **采购限颤**: - 标准办公电脑: 单价不得超过10,000 元。 - 高性能工作站: 单价10,000 - 20,000 元，需部门总监 (Director)审批 - 特殊定制设备: 单价超过20,000 元，必须由IT总监特批，并提交CFO最终签字， 3. **招标要求**: 单笔采购总额超过50,000 元时，必须启动至少三方参与的公开招标流程。 ## 第二章:国内差旅标准(Domestic Travel) 1. **佳宿补贴(按城市等级)**: - 一线城市(北京、上海、广州、深圳):800元/晚。 - 新一线及二线城市:500元/晚。 - 其他城市:350元/晚。 2. **交通工具** - 飞行时长4小时以内仅限经济舱， - 高铁限二等座(部门副总及以上级别可选一等座)。 ## 第三章:商务招待与餐饮(Entertainment) 1. **招待标准** - 商务正餐: 人均限额300元。若超过300 元/人(如上海、香港等高消费地区最高可至500 元/人)，需附完整参会名单并提交业务副总裁(VP)特批。 2. **随访要求**: 内部陪同人员人数不得超过外部客人数。 ## 第四章:日常零星报销 1. **自主额度**: 单笔500 元以下的办公杂费支出可由员工自主报销。 2. **主管审批**: 500元至5,000元的支出由部门直接主管在系统内审批。 ## 第五章:市场活动与公关 1. **预算申报**: 所有涉及品牌推广、市场活动的预算需提前14天提交0流程申报， 2. **礼品采购**: 单份赠礼价值上限为300元。 -- *注:以上所有金额单位均为人民币(CNY)。违反以上限额且未获得特批的申请，财务部将予以退回。*

在指令部分加入财务提醒部分：

... ## 总结规则 请将会议内容总结为以下几点: - 参会人员 - 议题 - 决定 - 财务提醒: 仅在提到"钱,预算,采购,费用"的时候触发。必须读取reference 文件夹中的`集团财务手册.md`,指出决定中的金额是否超标，并明确审批人。 注意: 每一项都只能分别使用一句话来表述，不要分成多条。 ...

然后测试：

可以看到，会议内容中包含了"钱" ，Claude Code 就加载了集团财务手册.md 丢给了大模型，结果中就包含了"财务提醒"

记住： reference 是条件触发的。当读取了 SKILL.md 后，需要查账的时候才需要加载集团财务手册.md文件，所以它是按需中的按需。

6.高级用法-Script

可以让 Claude Code 来执行脚本。这里将脚本save_text.py保存到了scripts目录下：

importsysif__name__=="__main__":iflen(sys.argv)<2:print("用法: python save_text.py '要保存的文本'")sys.exit(1)text=sys.argv[1]filepath="output.txt"withopen(filepath,'w',encoding='utf-8')asf:f.write(text)print(f"文本已保存到:{filepath}")

修改指令：

... ## 保存文件规则 如果用户提到了"保存",或者"写入文件" ,你必须运行scripts目录中的save_text.py 脚本将总结内容保存到文件中，脚本使用方法:

python sve_text.py “会议总结内容”

...

测试：(注意要安装python环境，我用的是mini conda)

脚本只是在运行，并不会消耗Token

7.Agent Skill 与 MCP

MCP: 给大模型提供数据，比如：查询昨天的销售记录，读取订单的物流状态信息

本质上是一段可以独立运行的程序

Agent Skill：教大模型如何处理数据，比如：会议总结必须要有议题，汇报文档必须包含数据。

本质上是一段说明文档

虽然它们的功能相似，但它们的本质不同，适用的场景也不一样。 Agent Skill更适合跑一些比较轻量级的脚本，处理简单的逻辑。代码执行方面，Agent Skill的安全性和稳定性都不及MCP，所以要根据场景来选择工具。有适合它们甚至需要配合起来使用