技能三件套并为skill(op=list/get/run):同一标识空间+生命周期按规范§一合并,§七配套关系转为op间依赖并迁入tool description;input_args降为可选缺省{}(缺参由技能input_schema点名报错,免双重门槛);mini整工具放行顺带获得op=list;模板/注入段/config allow/README/SKILL.md/ARCHITECTURE同步改名,tool-design补§二持久资源动作归并澄清

This commit is contained in:
2026-09-23 08:15:59 +08:00
parent d51add1893
commit 3555d29465
14 changed files with 133 additions and 72 deletions
+6 -6
View File
@@ -8,9 +8,9 @@
技能是一个自包含的目录,通常存放在技能根目录(默认为 `skills/`)下。每个技能包含一个描述文件(`SKILL.md`)和一个可执行入口(`run.py` 或 `run.sh`)。Agent 通过以下流程使用技能:
1. 调用 `list_skills` 查看所有可用技能的名称和简介;
2. 调用 `get_skill_info` 获取某个技能的详细说明;
3. 调用 `run_skill` 执行技能,传入所需参数。
1. 调用 `skill`(op=list)查看所有可用技能的名称和简介;
2. 调用 `skill`(op=get)获取某个技能的详细说明;
3. 调用 `skill`(op=run)执行技能,传入所需参数。
技能可以处理任何任务,例如文件格式转换、数据处理、网页抓取等。
@@ -56,7 +56,7 @@ output_schema:
```
- `name`:技能名称,应与目录名一致。
- `description`:一句话描述技能功能,用于 `list_skills` 展示。
- `description`:一句话描述技能功能,用于 `skill` op=list 展示。
- `input_schema`:输入参数的 JSON Schema 定义,用于参数校验和文档生成。
- `output_schema`:输出结果的描述(可选)。
- 若未提供 Front Matter,系统会尝试从正文第一行提取描述。
@@ -78,7 +78,7 @@ output_schema:
- 自动处理某某
## 使用说明
通过 `run_skill` 调用,参数:
通过 `skill`(op=run)调用,参数:
- `input`:某某路径(必填)
- `output`:某某路径(可选,默认与输入同名)
```
@@ -226,7 +226,7 @@ input_schema:
---
## 使用说明
通过 `run_skill` 调用,参数:
通过 `skill`(op=run)调用,参数:
- `text`:要回显的文本(必填)
```
+1 -1
View File
@@ -87,7 +87,7 @@ output_schema:
- `grid`:把同一目录下多张图拼成一张 contact sheet(缩略图网格)
## 使用说明
通过 `run_skill` 调用,参数 `input_args`:
通过 `skill`(op=run)调用,参数 `input_args`:
- `action`:操作类型(必填)
- `input`:输入图片或目录(必填;相对会话工作目录的路径即可,会自动转绝对路径)
- `output`:输出路径(建议给全;不给时自动生成 `<原名>_<动作>.<原扩展名>`,绝不覆盖原图)
+1 -1
View File
@@ -29,6 +29,6 @@ output_schema:
- 自动处理中文字体
## 调用方式
通过 `run_skill` 调用,参数:
通过 `skill`(op=run)调用,参数:
- `input`:Markdown 文件路径(必填)
- `output`:PDF 输出路径(可选,默认与输入同名)