refactor(skill): 参数改为动词作键,去掉 op/name/input_args

形状:{"list":"all"} / {"get":"<名>"} / {"run":"<名>","args":{...}},三者恰好给一个。
- 互斥无法用 required 表达,校验与报错回显放在 toolSkill
- list 取值是字符串范围而非布尔,为将来的技能分类留扩展位;今天只认 all
- list/get 带非空 args 一律报错,不静默丢弃
- 旧形状 {op,name,input_args} 仍由 toolSkill 兜底翻译,只为兼容存量技能文档,不再对外文档化
- README/AGENTS/skills 文档与内置技能调用示例同步为新形态
This commit is contained in:
2026-10-21 09:25:25 +08:00
parent 767caa8574
commit 76a0e9ad86
15 changed files with 124 additions and 73 deletions
+3 -3
View File
@@ -10,7 +10,7 @@ mcp_tool: image_task
## 参数
`input_args` 原样透传给底层服务:
`args` 原样透传给底层服务:
- `op=create`:`prompt` 必填。描述越具体越好(主体、风格、构图、光线、画面里的文字要求)。
- `op=get`:`task_id` 必填,取回任务状态;`SUCCESS` 时返回图片 URL。
@@ -20,7 +20,7 @@ mcp_tool: image_task
1. 提交
```
skill op=run name=image input_args={"op":"create","prompt":"一只橘猫趴在窗台上晒太阳,水彩风格"}
skill {"run":"image","args":{"op":"create","prompt":"一只橘猫趴在窗台上晒太阳,水彩风格"}}
```
→ 返回 `task_id` 与 `task_status: PROCESSING`
@@ -28,7 +28,7 @@ mcp_tool: image_task
2. 查询
```
skill op=run name=image input_args={"op":"get","task_id":"<上一步返回的 id>"}
skill {"run":"image","args":{"op":"get","task_id":"<上一步返回的 id>"}}
```
→ `SUCCESS` 时返回 `Image N: <url>`