type
Post
status
Published
date
Feb 18, 2026
slug
summary
在构建 AI Agent 的过程中,我们经常面临一个两难的境地:要么把所有的指令和背景知识一股脑塞进 Context Window(上下文窗口),导致成本飙升且注意力分散;要么在此刻仅提供最通用的 Prompt,导致模型在特定领域的表现平平。
Anthropic 最近推出的 Agent Skills 架构,似乎为解决这个问题提供了一个优雅的方案。它不仅仅是功能的扩展,更像是一种将 AI 从“通用处理器”转化为“领域专家”的操作系统级设计。
今天我们就基于这份详尽的学习指南,来扒一扒 Agent Skills 到底硬核在哪里。
tags
思考
学习
category
我的随笔
icon
password
什么是 Agent Skills?
简单来说,Agent Skills 是一种基于文件系统的模块化能力包。
传统的 Agent 开发往往依赖于庞大的 System Prompt 或动态生成的代码。而 Agent Skills 将指令(Instructions)、元数据(Metadata)和资源(如脚本、模板)打包成独立的文件夹。
想象一下,你的 Claude 不再是一个只懂聊天的通才,而是一个可以通过加载不同“技能包”瞬间变身为数据分析师、文档处理专家或运维工程师的变形金刚。
核心黑科技:“渐进式披露” (Progressive Disclosure)
这可能是 Agent Skills 架构中最精妙的设计。为了解决 Context Window 的拥挤问题,Skills 采用了三层加载机制:
- 启动时 (Startup): 仅加载 元数据 (Metadata)。Claude 知道有哪些技能可用,但不知道具体细节。
- 触发时 (Triggered): 仅当 Claude 决定调用某个技能时,才会加载 指令 (Instructions)。
- 执行时 (Execution): 仅当具体任务需要时,才会读取具体的 资源或代码 (Resources)。
这意味着什么? 这意味着你可以给 Agent 挂载成百上千个复杂的技能,甚至包含海量数据集,但在你真正用到它们之前,它们几乎不占用任何 Token。这极大地解决了传统工具调用中的“冷启动”和成本效率问题。
技术实现:解剖 SKILL.md
每个 Skill 的核心是一个
SKILL.md 文件。对于喜欢动手的开发者来说,这里的结构非常清晰:- YAML Frontmatter: 必须包含
name(小写字母数字,用于调用)和description(用于路由和发现)。这是 Agent 的“寻址表”。
- 指令正文: 具体的 Prompt 指南。
为什么是脚本 (Scripts) 而不是生成代码?
这是一个非常 Geek 的设计选择。Agent Skills 鼓励在包内包含预写好的脚本(如 Python 或 Bash 脚本),而不是让 LLM 现场生成代码。
- 确定性 (Deterministic): 预写脚本对于排序、文件操作等任务是 100% 可靠的,没有幻觉。
- Token 节省: 通过 Bash 执行脚本时,代码本身不会进入上下文,只有输出结果会消耗 Token。对于复杂逻辑,这比让 AI 写代码再运行要省钱得多。
开发者备忘录:API 与安全
如果你正准备通过 Claude API 接入这一能力,有几个关键点需要注意:
1. 必不可少的 Beta Headers
要跑通这个流程,你需要在 API 请求中带上这三个“入场券”:
code-execution-2025-08-25: 开启代码执行容器。
skills-2025-10-02: 开启 Skills 功能。
files-api-2025-04-14: 用于文件上传下载。
2. 安全是重中之重
由于 Skills 可以包含二进制文件和脚本,Anthropic 建议将其视为安装软件。永远不要在未审计的情况下运行来源不明的 Skill,因为恶意的
SKILL.md 或脚本可能会尝试渗出数据或执行危险的 Bash 命令。3. Skills vs. MCP (模型上下文协议)
别搞混了。
- MCP (Model Context Protocol) 主要是为了连接“外部世界”的数据(如读取数据库、API)。
- Skills 主要是为了封装“内部逻辑”和“工作流”(如处理数据、生成特定格式报告)。
两者是互补关系,一个负责“拿数据”,一个负责“干活”。
SO…
Agent Skills 的出现,标志着 AI 应用开发正在从简单的 Prompt Engineering 转向更工程化的 Agent Engineering。通过将领域知识固化为模块化的 Skill,我们不仅能提高 AI 的产出质量,还能在保持低成本的同时,让 Agent 变得越来越“厚重”和专业。
对于像我们这样喜欢自己动手搭建项目的开发者来说,这无疑是一个巨大的游乐场。
- 作者:Leisurelywolf
- 链接:https://blog.869669.xyz//essay/30b6b39a-856d-802e-ba38-d6529e4068d0
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
相关文章


