服务注册与分布式协调 / 系统课时
统一 Prompt 与 MCP 资源
统一 Prompt 与 MCP 资源
把 Prompt、Skill 与 MCP Server 放进同一个 AI 资源中心,不等于把它们建成同一种对象。本节从版本、标签、可见性和运行时消费方式划清统一治理边界,并给出 Agent 平台可直接采用的资源模型。
学习目标
- 区分 Prompt、Skill 与 MCP Server 的资源形态和运行时消费方式
- 设计三类资源可共用的命名空间、版本、标签、可见性与审计边界
- 判断哪些能力应统一治理,哪些类型差异必须保留
先统一治理面,不统一运行时形态
AI Registry 的价值是让平台用同一套入口管理 AI 应用依赖的资源,但三类资源解决的问题不同。Prompt 是可读取的模板内容,Skill 是可分发和加载的能力包,MCP Server 则是运行时可发现、可连接、可调用的服务入口。
因此,资源中心应统一“谁能看、哪个版本可用、谁发布过、当前是否可用”,而不是强行统一“如何执行”。如果把三类对象都抽象成一段配置文本,MCP 的端点与工具状态会丢失;如果都按在线服务处理,Prompt 和 Skill 的版本内容又难以审计与回滚。
| 资源类型 | 核心内容 | 版本与选择方式 | 运行时消费方式 | 重点治理对象 |
|---|---|---|---|---|
| Prompt | 模板、变量定义、描述 | 版本;常用标签指向推荐版本 | 按 Prompt Key 加版本或标签读取 | 模板变更、变量兼容、标签切换 |
| Skill | Skill 包、说明文件、资源文件 | 版本;可用标签选择稳定或灰度版本 | Agent 或工具链下载并加载 | 包来源、审核、可见性、分发范围 |
| MCP Server | 服务描述、工具、资源、端点 | 服务版本与能力元数据 | MCP Client、Router 或 Agent 发现后发起协议调用 | 端点、工具开关、协议暴露、可发现性 |

用公共资源信封承载共同字段
平台侧可以为所有 AI 资源定义一层“公共资源信封”,只承载跨类型都成立的元数据:命名空间、资源类型、稳定名称、Owner、业务标签、可见性、发布状态、版本信息和审计记录。真正的内容放在类型专属部分,不要求字段完全一致。
命名空间负责第一层隔离,生产、测试以及不同租户不要混在同一个空间。可见性则解决同一命名空间内谁能发现资源;业务标签用于分类与检索,不应替代版本号。两者职责不同,避免把“private”“prod”之类信息全塞进一个标签集合。
版本也要区分“不可变内容”和“可移动指针”。已经发布的 Prompt 或 Skill 版本应当视为可追溯快照,需要修改时创建新版本;latest、stable、canary 这类标签更适合充当指向具体版本的可移动指针。生产调用若要求行为完全固定,应直接锁定版本;希望平台可控升级时,再通过约定标签切换。
保留类型专属的运行时契约
Prompt 的稳定契约主要是变量名和模板语义。变量删除、改名或类型约定变化,可能让调用方在渲染阶段直接失败,所以发布检查应重点验证必填变量、默认值和模板渲染结果。
Skill 的契约是包内容以及加载约定。除了版本和可见性,还要关心包来源、说明文件、依赖资源是否完整,以及运行时是否允许下载。它更像“可分发工件”,不应该被当成实时服务做健康探测。
MCP Server 的契约则是可发现的服务能力。除了资源版本,还存在端点、协议、工具列表和工具开关等动态信息。运行时通常先发现服务,再选择工具并发起调用,因此治理中心要允许服务元数据变化与实际端点状态保持同步,而不能只保存一份静态描述。
把 Agent 平台的消费策略写进资源边界
统一资源中心落地时,Agent 平台至少要明确三条消费策略:Prompt 是“取内容”,Skill 是“取包并加载”,MCP 是“取发现信息后调用”。这三条路径可以共享鉴权、审计、缓存和命名空间规则,但缓存时长、失败处理和更新策略不应完全相同。
例如,Prompt 标签切换后可以让应用在下一次拉取时获得新模板;Skill 升级通常需要重新下载并完成加载校验;MCP 发现结果变化则可能意味着端点切换或工具能力变化,需要客户端重新发现或刷新连接。把这三种更新语义拆开,统一资源中心才不会成为新的耦合点。
最终的边界应是:平台统一目录、权限、版本治理和审计,资源类型保留各自的内容模型与运行时契约。这样既能让 Agent 在一个入口找到所需能力,又不会为了“统一”牺牲 Prompt、Skill 和 MCP 本来不同的消费语义。