fix(skill): 参数改回 op/name/args 的扁平结构,压缩描述并修正调用示例

This commit is contained in:
2026-10-21 20:53:33 +08:00
parent 89c673864f
commit 29e46692fc
11 changed files with 65 additions and 103 deletions
+2 -3
View File
@@ -25,9 +25,8 @@
- 跨 op 共享的参数放顶层,description 说明哪些 op 用它;
- op 专属参数也放顶层,description 说明 `op=X 时必填`;
- 仅当参数结构在工具定义时无法确定时,才用自由对象 `{ "type": "object" }`。
- 动词 + 单 token 标识可以折叠成「动词作键、标识作值」(技能的 `{"get":"<名>"}` 即此形)。
多个动词互斥时 `required` 表达不了,必须在代码里校验,并在报错里回显全部合法形态;
取值范围暂只有一个时(如 `{"list":"all"}`)仍用字符串而非布尔,便于后续扩成分类等子集。
- 互斥的多动作一律用枚举开关 `op` + 各自顶层参数,不要把动作编码进键名:键名方案无法用
`required` 约束(漏键只能到运行时才发现),弱模型也更容易漏写。
### 四、条件必填