AI 产品与动态AI 应用

Agent Skills移交AAIF后怎么跨平台用?先验收一个不执行操作的技能样本

一个技能文件夹能在两个AI产品里打开,不代表它在两边都读到了相同资料、拥有同样工具,或会给出同样答案。Anthropic把Agent Skills移交中立基金会后,最实用的下一步不是批量安装,而是用一份小任务检查迁移究竟保留了什么。

散落的纸板拼图,作为技能包兼容与组装的摄影配图
配图:Alicia Christin Gerald · Unsplash License

先明确任务与结果

先核对SKILL.md的名称、描述与依赖,再用相同原始记录运行正常、缺资料与不该触发三类用例。本文提供自编技能片段、输入与人工参考答案,只返回待审阅笔记,不调用工具或发送信息。格式兼容与任务结果要分别验收。

10月22日变化的是标准归属,不是所有平台行为一致

Anthropic的原始公告宣布将Agent Skills捐赠给Linux Foundation旗下Agentic AI Foundation,并表示不加入基金会也能继续使用或贡献标准。公告中的后续版本化、提案流程和安全指导是拟议路线,不写成所有实现已具备的功能。

Agent Skills格式规范规定以SKILL.md为核心的目录格式,以及必需的name和description。可选compatibility可说明环境需求;allowed-tools仍标为实验性。某个声明存在,不能替主机授予权限或证明工具执行能力。

准备同一份交付缺口任务

本例是编辑设计的人工参考练习,没有在两家产品中做对比测试。使用你有权提供的虚构记录,避免先接入真实邮箱、仓库或客户资料。任务只需要输出一份笔记,因此可以把工具执行从首次验收中移开。

原始记录R1:压缩包能打开,要求的三张截图只找到两张,负责人Lin,下一步核对缺少哪张。R2:工作簿实际两个工作表,交付说明要求三个;记录写“Friday16:00”,没有日期和时区,也没有负责人。R3:三份附件全部找到,文件可打开,没有未解决项。

先写人工参考答案
ID观察与期望负责人下一步
R12张截图;应有3张Lin查明缺少的截图,不写成已补齐
R22个表;应有3个未知核对缺表、负责人以及Friday的日期和时区
R3已满足记录条件不列为缺口无需把完成项改成问题

用最小片段检查格式与任务边界

下面是可供读者建立自己样本的原创建议,不是已安装资源,也不是某产品的官方技能。文件夹名应与name一致;名称小写、数字和连字符等约束以当前规范为准。这里不附脚本和外部依赖,方便定位第一次失败。

自编SKILL.md片段

---
name: handoff-gap-note
description: Turn supplied delivery checks into a short gap note. Use when asked to summarize missing handoff evidence.
---
Use only the supplied records. For each unresolved record, output ID, observed, expected, owner, and next check.
Preserve IDs. Mark missing fields as unknown. Do not invent dates or turn an observation into a completed fix.
If a required reference file is absent, name the missing file and stop that part of the task.
Do not run commands, install packages, send messages, or alter files. Return the note for review.
仅整理读者提供的记录并返回笔记;本篇没有运行此技能或授权外部动作。

三类用例能分离出不同失败原因

先让两边使用完全相同的R1–R3,不要一边给原始材料,另一边给第一次生成的摘要。核对输出是否只列R1与R2,是否保持编号、Lin和数字,是否把Friday保留为不完整期限。流畅的格式不能抵消事实漏项。

第二轮有意给技能增加“读取references/checks.md”的要求,但不给该文件。参考行为是明确缺失依赖并停止这部分整理;不能偷偷编出一个核查表。第三轮改问无关的生日祝福,观察系统是否错误套用交付缺口流程。不同主机的发现方式与调用界面可能不同,按各自主机文档操作。

给每次失败找一个具体位置

加载失败

先查文件结构与必需字段,而不是马上换模型。

读取不到材料

核对文件是否打包、路径是否对应、主机能否访问。

答案偏离

用参考结果指出漏项或臆造,再改指令重跑同一输入。

不要靠放宽答案标准让迁移“成功”

如果R2被写成“负责人Lin,周五16点前已修复”,至少出现三处错误:把R1负责人套给R2、把不完整时间当确定截止、把待查改成完成。修复应明确逐行证据与未知字段,然后重跑;不能仅删掉那个难例。

要发布完整插件,另有安装、依赖与目录审核问题,可读Claude插件提交准备。要把固定任务做成可复用材料,再看会议待办技能的输入与模板。二者都不能替代本次相同任务的结果验收。

区分改指令与改事实

问题示例

R2:Lin已在周五16:00前补齐第三个工作表。

修正参考

R2:缺少第三个工作表;负责人未知;Friday16:00缺日期和时区;待人工确认。

修正后保留缺口,才符合材料。把未知写得确定不是跨平台能力提升。

保存的是迁移证据,而不是一句“支持标准”

记录主机与客户端版本、使用的模型、技能版本、输入、输出和失败项。若加入脚本或网络依赖,应另做执行权限、可用环境和实际结果检查。不要从无脚本样本推断有执行能力的技能也已通过。

本例的参考答案由原始记录人工整理;没有声称亲测两个产品、节省时间或所有账号均可使用。最终接受条件由读者任务决定:同样证据能得到同样必要信息,缺失资料不会被静默补造,超出任务的动作仍需真实授权。

这份小任务的迁移验收

  • 格式可被目标主机识别,依赖和调用方法明确。
  • R1与R2完整,R3没有被制造成缺口。
  • Friday与负责人未知保持未知,未伪造修复。
  • 缺文件用例明确报告缺失;无关任务未被错误套用。

常见问题

标准移交是否意味着Claude专有工具也能原样迁移?

不能推断。目录格式与某个主机提供的执行工具、账号功能和权限是不同层,必须逐项核对。

可以靠allowed-tools给技能增加权限吗?

不能把文件里的字段当作实际权限授予。该字段在规范中仍是实验性,主机支持与用户授权需要另行确认。

输出措辞不一样就算失败吗?

不用要求逐字一致。比较编号、数字、必要字段、未知状态和任务边界;自然改写可以接受,事实与范围改变不可以。

参考资料与延伸阅读

继续阅读