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:
@@ -25,6 +25,9 @@
|
||||
- 跨 op 共享的参数放顶层,description 说明哪些 op 用它;
|
||||
- op 专属参数也放顶层,description 说明 `op=X 时必填`;
|
||||
- 仅当参数结构在工具定义时无法确定时,才用自由对象 `{ "type": "object" }`。
|
||||
- 动词 + 单 token 标识可以折叠成「动词作键、标识作值」(技能的 `{"get":"<名>"}` 即此形)。
|
||||
多个动词互斥时 `required` 表达不了,必须在代码里校验,并在报错里回显全部合法形态;
|
||||
取值范围暂只有一个时(如 `{"list":"all"}`)仍用字符串而非布尔,便于后续扩成分类等子集。
|
||||
|
||||
### 四、条件必填
|
||||
|
||||
|
||||
Reference in New Issue
Block a user