![开场图](https://developer.qcloudimg.com/http-save/yehe-9261324/e04a66140db75a010d0992a06a9a5b4c.png)

客服退款 SOP 最容易暴露多 Agent 维护的问题：网页客服 Agent 一份 Prompt，工单 Agent 一份，内部运营助手又一份。规则一改，三处不同步；新人接手时，只能从历史对话里猜哪版有效。把这类流程沉淀为 Skill 包，核心不是“再写一份文档”，而是让专业流程可发现、可加载、可版本管理。

## 最小结构：目录加 SKILL.md

按 Agent Skills 规范，一个 Skill 至少是一个目录和必需的 `SKILL.md`。文件由 YAML frontmatter 与 Markdown 指令正文组成，可选携带 `scripts/`、`references/`、`assets/`。以退款 SOP 为例：

```text
refund-sop/
├── SKILL.md
├── references/
│   └── refund-policy.md
├── scripts/
│   └── check_order.py
└── assets/
    └── reply-template.md
```

`SKILL.md` 的有效 frontmatter 可以写成：

```yaml
---
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 说明能力，不授予权限；它提高流程复用的一致性，但不自动保证正确、安全或跨宿主行为完全一致。把这一点写进架构假设，比任何“一次编写、处处运行”的口号都更接近工程现实。

![结束图](https://developer.qcloudimg.com/http-save/yehe-9261324/3d3fcc248e43c4fb5b614be3dfd712d0.png)

客服退款 SOP 最容易暴露多 Agent 维护的问题：网页客服 Agent 一份 Prompt，工单 Agent 一份，内部运营助手又一份。规则一改，三处不同步；新人接手时，只能从历史对话里猜哪版有效。把这类流程沉淀为 Skill 包，核心不是“再写一份文档”，而是让专业流程可发现、可加载、可版本管理。

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

以客服退款 SOP 为例，说明 Skill 的最小结构、元数据约束、渐进式披露与生命周期治理，并区分 Skill、MCP 与 AGENTS.md 的边界。

架构师

人工智能

架构设计

开发工具

客服退款SOP多Agent场景常因Prompt分散导致规则不一致，解决之道在于将流程沉淀为Skill包，实现统一版本管理与按需加载。Skill通过元数据发现、指令激活、资源按需加载的渐进式披露，让流程可复用可回滚。其与MCP、AGENTS.md职责分明，企业需通过注册表与治理机制保障多Agent协作的规范性与安全性。

兼容性测试

数据接口

代码解释

Markdown

Agent

腾讯云双十一大促

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

89:AAIF开源项目Agent Skills研究实践-能力如何跨 Agent 复用？-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐