跳到主内容
智客 ZICQ

智客百科 AI 概念

Agent 技能(Agent Skills)

AI 概念
别名: Agent Skills SKILL.md 技能标准 ·2026-11-18

Agent 技能(Agent Skills)

Agent 技能(Agent Skills) 是一种面向 AI 智能体 的模块化能力封装规范(最初由 Anthropic 提出并演进为开放规范 agentskills.io)。它以 SKILL.md 文件为核心,将特定领域的工程流程、判断规范、参考资料与可执行脚本打包为独立目录,并被 Claude Code、Codex CLI、Cursor 等主流编码智能体广泛采用。

目录结构与 SKILL.md 解剖

一个标准的 Agent Skill 是一个自包含文件夹,只需一个核心说明文件 SKILL.md,按需附带脚本与参考材料:

my-skill/
├── SKILL.md          # 必填:YAML 元数据(name, description)+ Markdown 操作指令
├── scripts/          # 可选:确定性可执行脚本(Python / Bash 等)
├── references/       # 可选:按需读取的规范手册或 API 文档
└── assets/           # 可选:模板、配置文件或静态资源

SKILL.md 由两部分组成:

  1. YAML Frontmatter:定义机器可读的 name 与触发描述 description,告诉模型“何时应该启用该技能”。
  2. Markdown 正文:写明分步作业指令、校验门禁、边界约束与示例调用方式。

核心机制:渐进式披露(Progressive Disclosure)

如果把几十个领域的长篇 SOP 全部塞进系统提示词,会严重挤占上下文窗口并稀释注意力。Agent Skills 采用三段式渐进式披露来优化上下文工程:

  1. 发现阶段(Discovery):智能体启动时仅加载所有可用技能的 name 与一句话 description,每个技能仅占极少量 Token。
  2. 激活阶段(Activation):当用户请求命中技能描述(或通过 /skill-name 显式调用)时,运行时才按需把对应 SKILL.md 正文读入上下文。
  3. 执行阶段(Execution):模型按指令步骤执行任务,仅在需要时再去读取 references/ 中的细节文档或运行 scripts/ 里的确定性脚本。

与 MCP、提示词模板的区别

维度 Agent Skills (SKILL.md) MCP (Model Context Protocol) 普通提示词模板
核心解决什么 “按什么步骤与规范做事”(流程、经验与本地脚本) “如何安全连接外部工具与数据源”(标准化 RPC 协议) “单次对话怎么问”
运行时进程 无需常驻进程,纯文件系统目录 通常需要启动 stdio / SSE 服务进程 纯文本片段
上下文开销 渐进加载(触发前仅元信息) 需向模型注入 Tool Schema 定义 需手动粘贴
互补关系 技能正文常指导 Agent 正确组合调用多个 MCP 工具 负责底层认证、权限与数据读取执行 适合一次性单轮任务

工程实践与安全边界

  • 精准编写触发描述:description 既要写清“用来做什么”,也要写清“什么时候使用 / 不适用”,避免无关任务误触发加载。
  • 脚本兜底确定性逻辑:对于格式校验、文件切片、构建发布等确定性动作,优先封装进 scripts/ 由 Agent 调用,而非依赖模型口述手敲长命令。
  • 第三方技能审计:由于技能可附带可执行脚本与隐性指令,从外部仓库安装技能前应审查 SKILL.md 与 scripts/ 内容,防范提示注入或恶意命令执行。

进一步阅读