Skip to main content

标准格式

Skill 采用 Anthropic 发起并发布为开放标准的 Agent Skills 格式,用来封装特定任务的指令、脚本和资源。其背景见 Anthropic 的 Agent Skills 介绍,格式定义以 Agent Skills 官方规范为准。 一个 Skill 是一个目录,入口为 SKILL.md
  • YAML frontmatter 必须包含 namedescription,说明名称、用途和使用时机。
  • Markdown 正文描述执行步骤、注意事项和示例。
  • 可选的 scripts/references/assets/ 存放脚本、参考资料和模板等资源。
标准采用渐进式加载:先识别元数据,激活时读取指令,需要时再读取附属资源。Skill 不只是 prompt 模板,也不等同于可调用的 Tool;执行其中的操作仍需要宿主提供相应工具和权限。

平台管理

Hub 负责 Skill 的登记、存储与 Agent 绑定,Runtime 在部署后加载。这些管理和交付流程属于 Zerone 的实现,不是 Agent Skills 格式本身的要求。 Skill 以包含 SKILL.md 的包交付,可保存到 S3 兼容对象存储并通过签名地址下载。更新后,需要重新部署或重启对应执行环境才能确保新内容生效。

推荐做法

  • 描述应说明何时使用,而不仅是功能名称。
  • 一个 Skill 聚焦一个稳定任务。
  • 不在包内保存 token、密码或内部端点。
  • 由管理员通过 Agent 绑定明确可用性和授权。
需要执行外部操作时,配置相应的 Tool 查看领域实现