跳转至

Agent Skills(Agent 技能)

agent-skills

定义

Agent Skills 是将领域知识、指令、脚本和资源打包为可发现、可加载的可组合单元的标准。每个技能是一个包含 SKILL.md 文件的目录,agent 在运行时按需发现和加载。

核心比喻:为新员工准备的入职指南。不是为每个场景定制 agent,而是让通用 agent 通过加载技能变成专家。

设计原则:渐进式披露(Progressive Disclosure)

三层结构控制 context 的加载粒度:

  1. Metadata(name + description)→ 始终在 system prompt 中
  2. SKILL.md body → agent 判断相关时读取
  3. 附加文件 → agent 按需深入

这使得技能的 context 容量理论上无上限——agent 使用文件系统按需导航,而非一次性加载。

与 Tool Design 的关系

Agent Skills 是 tool design 的更高层抽象:

  • Tool:单个操作的接口(函数签名 + 描述)
  • Skill:一组操作 + 上下文 + 流程指导的集合

ACI 原则中的"给工具好的文档"在技能中进化为"给技能好的 SKILL.md"。name 和 description 的质量直接影响 agent 是否在正确时机触发技能。

与 Harness Engineering 的关系

技能是 harness engineering 的模块化表达——将 harness 中的领域知识、约束和工具打包为可复用单元。这使得 harness 不再需要将所有知识硬编码在 system prompt 中,而是可以按需组装。

开放标准

2025 年 12 月作为开放标准发布(agentskills.io),支持跨平台可移植性。详见 Anthropic 的 Agent Skills 介绍

零 glue 实现示例:CLI-Anything 的 SKILL.md 自动生成

CLI-Anything 为 Agent Skills 标准贡献了一个"零 glue" 的具体范例:流水线 Phase 6.5 的 skill_generator.py 从 Click 装饰器、setup.py、README 自动抽取元数据,把 SKILL.md 生成到 cli_anything/<software>/skills/SKILL.md 并随 pip install 一起部署;生成的 CLI 启动 REPL 时自动在 banner 里显示 SKILL.md 的绝对路径。整个 "描述-发现-加载" 链路不需要额外 SDK,只用 POSIX 原语(pip / which / --help)。这印证了 agent-native-software 的 "POSIX 原语优先" 原则。

OpenAI 的对应实践

OpenAI 在 harness engineering 中采用了类似的渐进式披露思想——AGENTS.md 作为目录,docs/ 作为深层知识库,agent 按需导航。这与 Agent Skills 的三层结构本质相同,只是 OpenAI 将其实现为 repo 内的文档结构,而 Anthropic 将其标准化为跨平台的技能格式。

Skill OS:技能的 OS 级演进

AgenticOS Workshop 中 Chen 等人(上海交大)的论文"Skills are the new Apps — Now It's Time for Skill OS"提出了一个激进但逻辑自洽的观点:技能是新的应用程序,因此需要 OS 级的管理和编排。

如果技能是应用,那 OS 需要提供: - 技能发现与安装:类似包管理器,但面向 agent 能力 - 技能调度与并发:多个技能争用同一个 agent 的 context window 时如何调度 - 技能隔离:一个技能的失败不应拖垮整个 agent 的执行 - 技能组合:技能之间的依赖和编排需要 OS 级的原语支持

这将当前的 Agent Skills 标准(应用层的文件夹 + SKILL.md 约定)推向系统层的正式抽象。目前技能的生命周期管理完全由 harness 承担——Skill OS 的方向是让 Agent OS 原生支持这些操作。

与分形架构的关系

Agent Skills 的设计天然满足分形架构的四条规则:所有技能暴露相同的发现/加载/执行协议(统一接口),技能可以调用其他技能(递归组合),没有"根技能"和"叶技能"的区分(无特权根节点),技能的引导/注册在技能体系之外完成(胶水与逻辑分离)。这使得 Agent Skills 不仅是 harness 知识的模块化,更是一种分形化的知识组织方式。

相关概念

References

  • sources/anthropic_official/equipping-agents-agent-skills.md
  • sources/agenticos-workshop-asplos-2026.md