feat(skills): 技能支持 MCP 后端(front matter mcp_tool)
SKILL.md 声明 mcp_tool 时,op=run 不落 executor 沙箱,由 core 直接 mcp.callTool 转发:凭证留在 core(沙箱的 env 白名单本就会丢掉 *KEY/*TOKEN),模型只看到技能清单 里的一行描述。配合 mcp_servers[].mode: silent,工具不再进每轮请求的 tools 数组。 - skills.js: runSkill 在 absolutizeArgs 之前分流(否则 URL / 含斜杠的 prompt 会被 当路径改写);不做 input_schema.required 预检(参数与 op 相关,交给 MCP 服务) - listSkills 带出 mcp_tool;设置页技能卡显示 mcp 后端徽章 - server.js: 启动期自检,缺失后端 warn、两条路并存 info - 新增 skills/image、skills/video 两个纯文档技能(无 run.py) - skills/README、README、app/AGENTS 同步
This commit is contained in:
+27
-1
@@ -22,7 +22,7 @@
|
||||
skills/
|
||||
└── <skill-name>/
|
||||
├── SKILL.md # 技能描述文件(必须)
|
||||
├── run.py # 技能主入口(Python 脚本,推荐)或 run.sh
|
||||
├── run.py # 技能主入口(Python 脚本,推荐)或 run.sh;声明 mcp_tool 时不需要
|
||||
├── requirements.txt # Python 依赖(可选,若需要第三方包)
|
||||
├── install.sh # 系统级依赖安装脚本(可选,如 apt-get)
|
||||
└── ... # 其他技能相关文件(如字体、模板等)
|
||||
@@ -53,6 +53,7 @@ input_schema:
|
||||
output_schema:
|
||||
# 输出描述
|
||||
visit_url: /app/{task_id}/ # 可选:页面类技能的访问路径模板
|
||||
mcp_tool: image_task # 可选:声明后端为某个 MCP 工具(此时不需要入口脚本)
|
||||
---
|
||||
```
|
||||
|
||||
@@ -61,6 +62,7 @@ visit_url: /app/{task_id}/ # 可选:页面类技能的访问路径模板
|
||||
- `input_schema`:输入参数的 JSON Schema 定义,用于参数校验和文档生成。
|
||||
- `output_schema`:输出结果的描述(可选)。
|
||||
- `visit_url`:(可选)页面类技能声明的访问路径模板,`{task_id}` 占位执行时替换为会话 id。`op=run` 成功后由 core(tools/executor.js)拼上 `public_link.base_url`,在输出末尾追加一行「访问地址:<完整 URL>」——技能进程跑在 executor 隔离视图里不知道公网地址,完整链接只能 core 补;AI 拿到相对路径会原样转给用户,而相对路径打不开。
|
||||
- `mcp_tool`:(可选)声明该技能的后端是某个已注册的 MCP 工具(见 3.3)。声明后不需要 `run.py` / `run.sh`。
|
||||
- 若未提供 Front Matter,系统会尝试从正文第一行提取描述。
|
||||
|
||||
### 3.2 正文内容
|
||||
@@ -87,6 +89,30 @@ visit_url: /app/{task_id}/ # 可选:页面类技能的访问路径模板
|
||||
|
||||
---
|
||||
|
||||
### 3.3 MCP 后端技能(无入口脚本)
|
||||
|
||||
front matter 里写 `mcp_tool: <工具名>`,这个技能的 `op=run` 就不落 executor 沙箱,而是由 **core
|
||||
直接调用 `mcp.callTool`** 转发给 `mcp_servers` 里配置的服务:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: image
|
||||
description: AI 生成图片(CogView)。op=create 传 prompt 拿 task_id,再 op=get 取图片 URL
|
||||
mcp_tool: image_task
|
||||
---
|
||||
```
|
||||
|
||||
- `input_args` **原样透传**成 MCP 工具的 `arguments`;参数校验由 MCP 服务负责(不做
|
||||
`input_schema.required` 预检——MCP 工具的参数常与 op 相关,静态必填列表会误伤)。
|
||||
- **不经过沙箱**,所以也不需要密钥:凭证留在 core 的 `mcp_servers[].headers` 里。
|
||||
executor 的环境变量白名单会按名字丢掉 `*KEY` / `*TOKEN`,沙箱本来也拿不到。
|
||||
- 目的通常是省上下文:把该服务设成 `mode: silent`,工具不进模型的 tools 数组,模型只看到
|
||||
技能清单里的一行描述,需要时再用 `op=get` 读本文件。
|
||||
- `mcp_tool` 填**最终工具名**(与内置工具重名时会被加 `<服务名>__` 前缀,见 `app/AGENTS.md`)。
|
||||
- 启动时 core 会自检:声明的工具不在注册表里会打 `warn`,不会等到模型第一次调用才暴露。
|
||||
|
||||
---
|
||||
|
||||
## 4. 入口脚本
|
||||
|
||||
### 4.1 格式要求
|
||||
|
||||
Reference in New Issue
Block a user