Skills 导读

先确认当前是否真的需要 Skills,再决定要不要继续深入。

Skills 的核心价值不是“多一个字段”,而是把一些会反复出现在每个项目里的能力, 比如联网搜索、响应修复、schema 兼容处理,变成稳定的服务端能力。 这页先回答 4 个问题:它是什么、什么时候该用、哪些在 TheRouter 内执行、哪些可能产生额外费用。

什么时候先看这页
如果你已经能完成普通请求,但开始遇到联网搜索、JSON 修复、工具打包复用、跨 provider 工具兼容这些问题, 可以先看 Skills,评估是否适合改成服务端统一处理。

Skills 到底是什么

它是可复用能力包,不是新的模型,也不是普通 prompt 技巧。你把能力引用加到请求里, TheRouter 决定哪些能力注入、哪些执行、哪些只作为 schema bundle 下发。

skills-request.json
{
  "model": "anthropic/claude-sonnet-4.5",
  "messages": [{ "role": "user", "content": "总结最新 AI 监管变化。" }],
  "skills": [{ "id": "web" }, { "id": "response-healing" }]
}

3 类能力怎么区分

  • 内置 Skills: 由 TheRouter 管理和执行,比如 web search、response healing。
  • Schema Bundles: 更像工具定义和说明的复用,不会在 TheRouter 里真正执行外部逻辑。
  • 远程 Webhook: 执行逻辑在你自己的基础设施里,TheRouter 负责转发和边界控制。

什么时候适合用

适合
1. 同一类工具定义在多个项目里重复出现
2. 你想把联网、修复、执行边界统一放到服务端
3. 你不想在每个客户端里重复处理 provider 差异
4. 你需要团队级治理,而不是单机脚本

费用应该怎么理解

不是所有 Skills 都该收费。像 schema bundle 更接近配置复用,而 web search 这类会调用外部 API 的能力, 才可能产生显式外部成本。

计费方式通常分两类
可以把 Skills 理解成两类: 可解释的外部成本 平台能力费用。 这两类费用最好分开阅读。

下一步