标准格式
Skill 采用 Anthropic 发起并发布为开放标准的 Agent Skills 格式,用来封装特定任务的指令、脚本和资源。其背景见 Anthropic 的 Agent Skills 介绍,格式定义以 Agent Skills 官方规范为准。 一个 Skill 是一个目录,入口为SKILL.md:
- YAML frontmatter 必须包含
name和description,说明名称、用途和使用时机。 - Markdown 正文描述执行步骤、注意事项和示例。
- 可选的
scripts/、references/、assets/存放脚本、参考资料和模板等资源。
平台管理
Hub 负责 Skill 的登记、存储与 Agent 绑定,Runtime 在部署后加载。这些管理和交付流程属于 Zerone 的实现,不是 Agent Skills 格式本身的要求。 Skill 以包含SKILL.md 的包交付,可保存到 S3 兼容对象存储并通过签名地址下载。更新后,需要重新部署或重启对应执行环境才能确保新内容生效。
推荐做法
- 描述应说明何时使用,而不仅是功能名称。
- 一个 Skill 聚焦一个稳定任务。
- 不在包内保存 token、密码或内部端点。
- 由管理员通过 Agent 绑定明确可用性和授权。