快速结论
技能文件能被读取,只是迁移的一步。脚本依赖、工具名称、账号权限和产物验收仍需在目标宿主中核对,allowed-tools 当前还是实验字段。
- 标准以含 SKILL.md 的目录为基本单位。
- name 与 description 是前置元数据中的必需字段。
- 格式相同不代表每个宿主都提供相同工具和执行环境。
本次更新:10 月 23 日核对原始来源后新增,区分公告日期、可用状态和编辑建议。
Agent Skills 转入 AAIF 治理后,团队可继续使用既有开放格式。下面根据格式规范整理迁移核对方法,操作顺序为本站编辑建议,不代表已验证某个客户端兼容。
1. 清点完整目录
迁移前列出 SKILL.md、脚本、参考资料和静态资源,检查相对引用是否仍指向目录内正确位置。只复制主文件,可能丢失模板或执行依赖。
核对 YAML 前置元数据的 name 和 description;描述应帮助宿主判断何时使用技能。保留原作者与许可证信息,不能因标准开放就假定每个技能内容都没有使用限制。
2. 把运行条件单独记录
查看脚本需要的语言、系统包、网络、文件路径和账号连接。规范提供 compatibility 字段描述环境条件,但没有填写此字段,也不能证明技能没有依赖。
使用 DeepSeek 的应用,仍要先核对宿主是否支持技能发现和加载。模型名称不能代替宿主功能说明。
3. 对照工具与账号能力
| 层次 | 核对内容 |
|---|---|
| 格式 | 元数据、正文、相对路径能否正确读取 |
| 运行时 | 解释器、包和系统命令是否可用 |
| 工具 | 原技能引用的能力在新宿主中如何提供 |
| 账号 | 对应数据和操作权限是否存在 |
| 产物 | 文件、字段、引用和最终状态如何验收 |
规范中的 allowed-tools 仍属实验字段,不同实现的支持可能不同,不能靠复制它自动获得执行权限。
4. 先验收一个小任务
准备可恢复的样例输入与预期产物,观察宿主是否触发技能、读取必要参考资料并生成正确文件。先看结果与执行记录,再扩大范围。
如果要修改工具调用或脚本接口,保留原版本并记录变更。迁移报告分别写明“已读取”“依赖可用”“工具可调用”“任务通过”,便于定位问题。本文提供评估方法,没有替任何客户端作兼容认证。
参考资料
本文依据以下资料整理,版本与接口信息请以来源页面的现行说明为准。