89:AAIF开源项目Agent Skills研究实践-能力如何跨 Agent 复用?

客服退款 SOP 最容易暴露多 Agent 维护的问题:网页客服 Agent 一份 Prompt,工单 Agent 一份,内部运营助手又一份。规则一改,三处不同步;新人接手时,只能从历史对话里猜哪版有效。把这类流程沉淀为 Skill 包,核心不是“再写一份文档”,而是让专业流程可发现、可加载、可版本管理。
最小结构:目录加 SKILL.md
按 Agent Skills 规范,一个 Skill 至少是一个目录和必需的 SKILL.md。文件由 YAML frontmatter 与 Markdown 指令正文组成,可选携带 scripts/、references/、assets/。以退款 SOP 为例:
refund-sop/
├── SKILL.md
├── references/
│ └── refund-policy.md
├── scripts/
│ └── check_order.py
└── assets/
└── reply-template.md
SKILL.md 的有效 frontmatter 可以写成:
---
name: refund-sop
description: 处理电商订单退款咨询,判断可退条件并生成合规回复。适用于用户询问退款资格、到账时间或拒绝原因的任务。
license: internal-policy-v3
compatibility: 需要订单查询工具与退款政策知识库
metadata:
owner: customer-service-platform
version: 1.4.0
---
name 与 description 是必需字段。name 限 1—64 个字符,只允许小写字母、数字和连字符,不能以连字符开头或结尾,不能出现连续连字符,并且要与父目录名一致。description 非空,最长 1024 字符,应同时说明能力和适用任务。license、compatibility、metadata 用于声明许可、环境要求和扩展信息。allowed-tools 是实验性字段,不同 Agent 实现支持程度不同,不能当作通用权限控制机制。
渐进式披露:先发现,再激活,按需读资源
跨 Agent 复用的关键在加载过程,而不是把整包内容一次性塞进上下文。
第一层是元数据发现。Agent 启动时只读取各 Skill 的 name 和 description,建立可发现清单。此时它知道“有一个退款 SOP”,但还不知道具体步骤。
第二层是完整指令激活。任务与描述匹配后,宿主加载完整 SKILL.md,Agent 才看到判断条件、回复结构和升级路径。
第三层是资源按需加载。只有任务需要时才读取 references/refund-policy.md,或执行 scripts/check_order.py,或取用 assets/reply-template.md。引用文件应使用相对路径,目录层级保持浅而清晰。官方建议指令正文控制在约 5000 Token 以内、SKILL.md 少于 500 行,并用 skills-ref validate 检查格式。
这里要明确边界:Skill 被发现不代表一定触发;脚本是否执行、以什么权限执行,由宿主或 Harness 决定。Skill 本身不是模型、不是 Agent Runtime、不是 MCP Server,也不是权限授予机制。
和 MCP、AGENTS.md 各管一段
三者常被混为一谈,实际职责不同。
Skill 告诉 Agent 如何完成一类任务,承载流程、判断标准和资源组织方式。MCP 提供可调用的工具或数据接口,例如订单查询、退款提交。AGENTS.md 提供仓库局部约定,例如代码风格、测试命令和目录说明。
退款场景里,Skill 负责“先核验订单状态,再判断政策,最后按模板回复”;MCP 负责真正查到订单;AGENTS.md 则可能约束这个仓库里脚本的写法。把三者分开,跨 Agent 复用时才不会把工具权限、流程知识和仓库约定揉成一个不可维护的 Prompt。
生命周期:能复用,也要能回滚
企业实践不能只停在“写一个 SKILL.md”。至少应包含创建、评审、版本管理、发布、兼容性测试、灰度、回滚和使用审计。
来源审查是第一道门。第三方 Skill 的依赖和脚本必须审查,不能因为描述写得专业就直接加载。版本签名和发布审批用于确认“当前生效的是哪一版”。脚本沙箱限制执行环境,回归评测验证流程改动没有破坏既有判断。灰度与回滚则处理跨宿主差异:同一 Skill 在不同 Agent 中的发现路径、触发规则和脚本能力要逐一验证,不能假设行为完全一致。
商业化路径:Registry 与行业技能包
当 Skill 数量增长,企业需要一个 Skill Registry:集中登记元数据、版本、所有者、兼容范围和审计记录,让不同 Agent 按统一方式发现和拉取。再往上,可以把客服、研发排障、行业操作规范做成可订阅的技能包,按流程资产而非按 Prompt 交付。
这条路成立的前提是治理到位。Skill 说明能力,不授予权限;它提高流程复用的一致性,但不自动保证正确、安全或跨宿主行为完全一致。把这一点写进架构假设,比任何“一次编写、处处运行”的口号都更接近工程现实。


浙公网安备 33010602011771号