什么是 Skill?

Skill 在 Agent Skills 语境下是以 SKILL.md 为入口的可复用目录包,为兼容的 AI Agent 提供特定任务指令,并可附带 Scripts、References 与 Assets。

快速了解

全称AI 智能体技能
创建时间概念随 AI 智能体发展而演变,2023-2024 年正式形成
规范文档官方规范

工作原理

把目录视为版本化软件包

[Agent Skills 规范](https://agentskills.io/specification)要求目录中包含 SKILL.md;其 YAML Frontmatter 至少声明 name 与 description,Markdown 正文保存指令。可选 scripts/、references/ 与 assets/ 承载可执行辅助程序和支持材料。

兼容 Runtime 在 Discovery 阶段暴露精简 Metadata,Activation 后才加载完整指令,Execution 时按需读取资源。实验性的 allowed-tools Metadata 不能替代 Runtime Authorization。

分开文件格式、传输协议与执行权限

Prompt 是交互输入,常驻项目规则在配置作用域内持续生效,Tool 暴露可执行操作,Plugin 属于产品分发单元;Agent Skills 定义文件包。官方 [MCP Skills 扩展](https://modelcontextprotocol.io/extensions/skills/overview)可以发现并传输这些文件,但读取 Resource 不等于激活 Skill,也不授权其 Script 或 Tool。Context Assembly、Origin Identity、Approval、Credential、Side Effect、Cancellation 与 Recovery 仍由 Host 负责。

晋级前验证供应链与行为

固定 Source 与 Version,枚举所有文件并校验 Size / Digest,审查指令与依赖,声明 Compatibility,拒绝未审阅新增文件、路径逃逸、隐藏 Binary、Secret Collection 或意外 Network Access。第三方脚本使用受限 Sandbox、Scope Credential 与 Egress。

当前[企业 Skill 指南](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/enterprise)还区分 Trigger Accuracy、Isolation、Coexistence、Instruction Following 与 Output Quality;正向、负向、模糊和对抗路由用例应与任务成功和禁止副作用分开评测。

主要特点

  • 文件目录包:必需的 SKILL.md 提供 Metadata 与指令,可选 Scripts、References 与 Assets 提供扩展资源
  • 渐进式披露:Runtime 可先暴露 Metadata,触发后加载完整指令,再按需读取资源
  • 工作流层:Skill 编码流程、决策点、约束与输出要求,不负责协议连接
  • 行为依赖 Runtime:Invocation、Tool Name、可选字段、Permission、Context Budget 与 Sandbox 语义可能因 Client 而异
  • 可评测路由:正向与负向 Trigger Case 必须和执行质量、任务验收分开测量
  • 供应链制品:Source、License、Hash、Dependency、Permission、Network、Review 与 Rollback 都需要生命周期治理

常见用途

  1. 仓库工作流:为特定代码库封装本地架构规则、审查标准、测试命令与交付格式
  2. 文档处理:组合操作指令、确定性脚本、模板和格式参考,形成可复用文件流程
  3. 运维 Runbook:指导诊断与处置,同时把实时访问和 Authorization 留给获批 Tool 与系统
  4. 领域审阅:封装法律、安全、数据质量或内容 Checklist,并声明证据与 Escalation 边界
  5. Tool Orchestration:指导 Agent 在何时及如何编排内置或 MCP Tool,而不在指令中嵌入 Credential 或授权

示例

loading...
Loading code...

常见问题

Agent Skill 与 Prompt 或 AGENTS.md 有什么区别?

Prompt 在一次交互中提供指令,AGENTS.md 等常驻文件则在配置的项目作用域内提供持续规则。Agent Skill 是面向可识别工作流的可发现 Package:Runtime 先读取 Metadata,只在选中后加载完整指令。不同产品的 Scope 与 Precedence 规则仍决定这些指令源如何共同生效。

Agent Skill 与 Tool 或 MCP Server 是同一种东西吗?

不是。Tool 暴露一个可执行操作,MCP Server 向 Host 暴露协议能力与实时数据;Skill 则封装可复用指令、Decision Point、Reference、Template 与可选 Script。Skill 可以指导 Agent 使用包括 MCP Tool 在内的工具,但 MCP 不是 Skill 文件格式,Skill 也不会授予 Authorization。

Agent Skill 能在所有 AI Agent 之间直接移植吗?

核心目录与 SKILL.md 格式只能移植到实现 Agent Skills Specification 的 Client,行为仍可能因 Discovery Path、Invocation Rule、Optional Metadata、Tool Name、Model、Context Budget、Sandbox 与 Permission System 不同而变化。发布前应在每个目标 Runtime 上执行兼容性和回归测试。

如何安全安装第三方 Agent Skill?

应把它当作不可信软件依赖:核验 Source 与 License,固定 Commit 或 Package Version 和 Hash,审查每条指令、脚本、Asset、Dependency 与 Network Destination,再使用 Least Privilege、Scope Credential 与 Sandbox 运行。高影响操作需要 Approval,并保留 Log、禁用与 Rollback 路径。

Agent Skill 应如何评测和版本化?

先用直接、间接、不完整、负向与对抗请求测量 Trigger Precision 与 Recall,再评测任务验收、Forbidden Action、Tool Use、Permission、Recovery、Token、Latency 与 Cost。结果必须绑定精确 Source、Artifact Hash、Specification Snapshot、Runtime、Model、Dependency、Policy 与 Eval Suite Revision。

相关工具

相关术语

相关文章