feat(mcp): 增加 mode=skill,把 MCP 工具以技能形式暴露
mode 三态改为 advertise / skill / disable: - skill 不下发到 tools 数组,由 skill 工具的 list/get/run 暴露 - get 返回 MCP 原始的 description + input_schema;run 直接转发,不做路径改写与 required 预检 - 移除 mode: silent(不设专门迁移文案)与 front matter mcp_tool 包装 - 删除 skills/image、skills/video,改由 image_task / video_task 的 mode: skill 提供 - 技能清单改用 listCallableSkills(目录 + MCP,同名时目录胜出);设置页仍只列目录 - init.sh 配了 BIGMODEL_KEY 时给 image_task / video_task 写 mode: skill - image_task / video_task 的 tool description 首行改为自解释的一句话(技能清单取首行)
This commit is contained in:
@@ -1504,6 +1504,8 @@ function toolDb(ctx, args) {
|
||||
// list 的值是范围而非布尔:将来技能分类落地时直接扩成 {list:"<分类>"},调用形状不变,
|
||||
// 模型不用学第二套写法。今天只认 "all" 且报错点名——静默返回全部会让错拼的分类名
|
||||
// 看起来「能用」,将来接分类时更难排查。
|
||||
// {list:"all"} 的清单 = 目录技能 + mode=skill 的 MCP 工具;get/run 对两者一视同仁:
|
||||
// 目录技能读 SKILL.md,MCP 技能直接回注册表里的原始 input_schema。
|
||||
// args 仅 run 用且可缺省:runSkill 把 null 视作 {},真正缺哪些字段由各技能 input_schema
|
||||
// 校验点名报错(工具层再 gate 一层是双重门槛,无益)。
|
||||
// 旧形状 {op, name, input_args} 仍接受:存量技能文档的调用示例里写的是它,模型 get 到
|
||||
@@ -1554,7 +1556,7 @@ async function legacyToolSkill(ctx, a) {
|
||||
const name = String(a.name == null ? '' : a.name).trim();
|
||||
switch (op) {
|
||||
case 'list':
|
||||
return JSON.stringify(await skills.listSkills(ctx), null, 2);
|
||||
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||
case 'get':
|
||||
if (!name) throw new Error('op=get 缺少技能名。' + SKILL_USAGE);
|
||||
return skills.getSkillInfo(ctx, name);
|
||||
@@ -1582,7 +1584,7 @@ async function toolSkill(ctx, args) {
|
||||
const scope = String(a.list).trim().toLowerCase();
|
||||
if (scope !== 'all') throw new Error('list 目前只支持 "all"(技能分类尚未提供),收到:"' + scope + '"');
|
||||
rejectSkillArgs(a, 'list');
|
||||
return JSON.stringify(await skills.listSkills(ctx), null, 2);
|
||||
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||
}
|
||||
const name = skillNameArg(a[verb], verb);
|
||||
if (verb === 'get') {
|
||||
|
||||
+53
-37
@@ -4,8 +4,9 @@
|
||||
// 技能统一存放于技能根目录(cfg.skills_root,所有任务/会话共享;容器内挂 ./skills → /workspace/skills),每个技能一个子目录:
|
||||
// <skill>/SKILL.md(必须)、run.py | run.sh(入口)、requirements.txt、install.sh(可选)。
|
||||
// 入口脚本约定接收一个 JSON 字符串作为唯一命令行参数(含全部 args)。
|
||||
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(front matter 声明 mcp_tool,
|
||||
// run 由 core 直接调 mcp.callTool,不经沙箱——凭证留在 core,模型只看到一行技能描述)。
|
||||
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(core 直接 mcp.callTool 转发,
|
||||
// 不经沙箱——凭证留在 core)。MCP 技能不落目录:服务配成 mode=skill 时由平台自动暴露,
|
||||
// 参数契约直接取注册表里的原始 input_schema。
|
||||
const fs = require('fs');
|
||||
const fsp = require('fs').promises;
|
||||
const path = require('path');
|
||||
@@ -13,7 +14,7 @@ const { spawn } = require('child_process');
|
||||
const YAML = require('yaml');
|
||||
const log = require('../log');
|
||||
const rexec = require('../remote-exec');
|
||||
// 技能可声明 mcp_tool(front matter),run 时由 core 直接转发给 MCP;mcp.js 只依赖 ./log,不成环。
|
||||
// mode=skill 的 MCP 工具在 get/run 时由 core 直接转发;mcp.js 只依赖 ./log,不成环。
|
||||
const mcp = require('../mcp');
|
||||
|
||||
class SkillNotFoundError extends Error {
|
||||
@@ -68,22 +69,44 @@ async function listSkills(ctx) {
|
||||
let content;
|
||||
try { content = await fsp.readFile(mdPath, 'utf8'); } catch (_) { continue; }
|
||||
// frontmatter 可选 required: true —— 进 system prompt 时行首标 **required**(配合模板里的强制条款)
|
||||
// 可选 mcp_tool: <MCP 工具名> —— 声明后端为 MCP 服务(run 不落沙箱),仅在声明时带该键
|
||||
let required = false, mcpTool = '';
|
||||
let required = false;
|
||||
try {
|
||||
const fm = parseFrontMatter(content);
|
||||
required = fm.required === true;
|
||||
mcpTool = String(fm.mcp_tool || '').trim();
|
||||
required = parseFrontMatter(content).required === true;
|
||||
} catch (_) {}
|
||||
const item = { name: e.name, description: extractDescription(content), required: required };
|
||||
if (mcpTool) item.mcp_tool = mcpTool;
|
||||
out.push(item);
|
||||
out.push({ name: e.name, description: extractDescription(content), required: required });
|
||||
}
|
||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||
return out;
|
||||
}
|
||||
|
||||
// ---------- MCP 技能(mode=skill)----------
|
||||
// mode=skill 的服务:工具不进 tools 数组,而是自动成为技能。既省掉每轮的 schema 开销,
|
||||
// 又不用在 skills_root 里建目录、手抄一份参数说明——get 直接返回注册表里的原始 input_schema。
|
||||
// 目录技能优先:同名时目录技能胜出并打 warn。手写包装可以遮住自动版,迁移期也不会撞车。
|
||||
|
||||
// MCP 的 description 常是多段文本;清单里只取第一行,完整内容留给 get。
|
||||
function firstLine(s) {
|
||||
const line = String(s == null ? '' : s).split(/\r?\n/).map(l => l.trim()).find(Boolean);
|
||||
return line || '(无描述)';
|
||||
}
|
||||
|
||||
// 模型可见的技能全集 = 目录技能 + mode=skill 的 MCP 工具。
|
||||
// 设置页的技能 API 只用 listSkills(它按目录增删改),不要混用这个函数。
|
||||
async function listCallableSkills(ctx) {
|
||||
const dir = await listSkills(ctx);
|
||||
const taken = new Set(dir.map(s => s.name));
|
||||
const out = dir.slice();
|
||||
for (const t of mcp.skillTools()) {
|
||||
if (taken.has(t.name)) {
|
||||
log.warn('skills', 'MCP 工具 ' + t.name + ' 与目录技能同名,按目录技能处理(mode=skill 的这份被遮蔽)');
|
||||
continue;
|
||||
}
|
||||
out.push({ name: t.name, description: firstLine(t.description), required: false });
|
||||
}
|
||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||
return out;
|
||||
}
|
||||
|
||||
// ---------- system prompt 注入:可用技能列表 ----------
|
||||
// 把技能列表格式化成 “## Available Skills” 段落(每行 `- [**required** ]名字: 描述`;
|
||||
// listSkills 已按名字 localeCompare 排序,行序恒定,不破坏前缀缓存;
|
||||
// 参数查 get,执行 run;描述如需实时复核仍可查 list)。
|
||||
@@ -104,10 +127,12 @@ function formatSkillListForPrompt(list) {
|
||||
async function getSkillInfo(ctx, skillName) {
|
||||
const dir = skillDir(ctx, skillName);
|
||||
const mdPath = path.join(dir, 'SKILL.md');
|
||||
if (!fs.existsSync(mdPath)) {
|
||||
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
||||
}
|
||||
return fsp.readFile(mdPath, 'utf8');
|
||||
if (fs.existsSync(mdPath)) return fsp.readFile(mdPath, 'utf8');
|
||||
// mode=skill 的 MCP 技能没有目录:直接返回注册表里的原始契约(description + input_schema),
|
||||
// 模型看到的就是服务端实际声明的参数,不存在手抄副本漂移的问题。
|
||||
const t = mcp.getSkillTool(skillName);
|
||||
if (t) return JSON.stringify({ name: t.name, description: t.description, input_schema: t.parameters }, null, 2);
|
||||
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
||||
}
|
||||
|
||||
// ---------- 参数路径预处理 ----------
|
||||
@@ -217,7 +242,16 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
throw new SkillExecutionError('技能参数必须是对象(键值参数),收到:' + JSON.stringify(inputArgs).slice(0, 80), 1);
|
||||
}
|
||||
const dir = skillDir(ctx, skillName);
|
||||
if (!fs.existsSync(dir)) throw new SkillNotFoundError('技能不存在:' + skillName);
|
||||
if (!fs.existsSync(dir)) {
|
||||
// mode=skill 的 MCP 技能:直接转发。同样不做 absolutizeArgs——URL 与含 '/' 的 prompt
|
||||
// 会被当成路径改写坏;也不做 validateArgs,参数与 MCP 工具自己的 op 相关。
|
||||
const t = mcp.getSkillTool(skillName);
|
||||
if (t) {
|
||||
log.info('skills', '执行 MCP 技能 ' + t.name + ' → ' + t.server + '/' + t.tool);
|
||||
return mcp.callTool(t.name, inputArgs || {}, ctx);
|
||||
}
|
||||
throw new SkillNotFoundError('技能不存在:' + skillName);
|
||||
}
|
||||
|
||||
const mdPath = path.join(dir, 'SKILL.md');
|
||||
if (!fs.existsSync(mdPath)) throw new SkillNotFoundError('技能缺少 SKILL.md:' + skillName);
|
||||
@@ -225,24 +259,6 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
let fm = {};
|
||||
try { fm = parseFrontMatter(await fsp.readFile(mdPath, 'utf8')); } catch (_) {}
|
||||
|
||||
// MCP 后端技能(front matter 声明 mcp_tool):run 不落沙箱,由 core 直接转发给 MCP 服务。
|
||||
// core 用 cfg.mcp_servers[].headers 里的凭证调服务,技能进程根本不参与——这是唯一
|
||||
// 既能让模型只看到一行技能描述、又能让 key 不出 core 的路径(executor 的 env 白名单
|
||||
// 会按名字丢掉 *KEY/*TOKEN,沙箱里既拿不到也不该拿到)。
|
||||
// 必须在 absolutizeArgs 之前分流:它把「像路径」的参数改写成会话目录下的绝对路径,
|
||||
// 而 URL(含 '/')与含斜杠的 prompt 都会中招。
|
||||
// 不跑 validateArgs:MCP 工具的参数是 op 相关的(如 op=create 才要 prompt),
|
||||
// 静态 required 列表会误伤 op=get。
|
||||
if (fm.mcp_tool) {
|
||||
const tool = String(fm.mcp_tool).trim();
|
||||
if (!mcp.hasTool(tool)) {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 的 MCP 后端不可用:' + tool +
|
||||
'(检查 mcp_servers 是否含该服务,且 mode 不为 disable)', 1);
|
||||
}
|
||||
log.info('skills', '执行 ' + skillName + ':mcp_tool=' + tool);
|
||||
return mcp.callTool(tool, inputArgs || {}, ctx);
|
||||
}
|
||||
|
||||
// 以下是脚本后端(run.py / run.sh):先把相对路径参数按会话任务目录转成绝对路径(缺任务目录时退回进程当前目录)。
|
||||
const args = absolutizeArgs(inputArgs || {}, ctx.taskDir || process.cwd());
|
||||
const payload = JSON.stringify(args);
|
||||
@@ -261,7 +277,7 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
entry = 'bash';
|
||||
cmdArgs = [runSh, payload];
|
||||
} else {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh(也未声明 mcp_tool)', 1);
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh', 1);
|
||||
}
|
||||
|
||||
// cwd:远端取会话目录(executor 侧命中 session 隔离,技能看到的 /workspace/tasks/<sid>
|
||||
@@ -273,4 +289,4 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
return runEntry(ctx, entry, cmdArgs, execCwd, timeoutMs);
|
||||
}
|
||||
|
||||
module.exports = { listSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
||||
module.exports = { listSkills, listCallableSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
||||
|
||||
Reference in New Issue
Block a user