英文版:
SKILL.en.md
orchestrator — 输入编排器 是做什么的?
轻量自写技能:无独立代码——接收输入,识别类型,转发至正确的处理器。
仓库中的技能
| 技能 | 使用场景 |
|---|---|
doc | PDF/DOCX/XLSX:提取文本、OCR、转换、拆分/合并页面 |
media | 视频/音频/图片/URL:摘要、文本提取、字幕、剪辑、帧提取、下载 |
paper | 按国际标准或越南常用格式撰写报告 |
web | 读取网页/新闻/社交媒体 + 搜索(Jina、agent-reach、exa) |
diagram | 为报告绘制 Mermaid 图表 / matplotlib 图表 |
orchestrator(本技能) | 编排上述技能 + 报告前的需求确认环节 |
一次安装所有技能以支持编排:npx skills add tpc-pascal/agent-skills --all(或 --skill orchestrator web doc media paper diagram)。
基于输入类型的路由表
| 输入 + 需求 | 处理器 |
|---|---|
| PDF/DOCX/XLSX(文本提取、OCR、转换、拆分/合并) | doc 技能 |
| 视频/音频/图片/媒体 URL(摘要、字幕、剪辑、帧提取、下载) | media 技能 |
| 读取网页/社交媒体/搜索(URL、文章、exa) | web 技能 |
| 基于来源撰写报告 | 需求确认(见下文)→ 在 paper 技能中选择一种报告类型 |
| 为报告绘制图表/示意图 | diagram 技能 |
报告需求确认
触发条件: 用户要求生成或重写报告;不适用于仅提取/转换的请求。
在深入研究或撰写报告之前,最多询问4个问题,仅询问缺失的部分:
-
类型: 国际标准报告还是越南常用报告?
-
目的与读者: 谁将阅读,需要回答什么问题?
-
输出格式: 语言、格式、及长度限制(如有)?
-
来源与范围: 需要使用的来源/部分;是否允许补充外部来源?
-
不重复询问已在请求或对话中提及的内容。如果用户授予自主决定权,选择合适的方案,并在可能影响结果时简要说明假设。
-
非必需信息无需等待回答;不必在了解来源前强制确定详细标题。
-
先通过合适技能提取内容,然后严格按照
paper的某一种类型撰写报告。
编排规则
- 输入语言提示——使用用户使用的语言回复。
- 明确输出文件:
<原始文件名>.<后缀>。不覆盖已有文件。后缀:文档.extract.md|.txt|.csv,摘要.digest.md,字幕.srt|.vtt,剪辑.clip-<t1>-<t2>.mp4,报告.report.md|.report.docx。 - 不导入输入——仅处理真实存在的文件,输出放置在/覆盖文件中;不自行添加文件。
- 网页/社交/搜索输入 →
web技能(Jina/agent-reach/exa)先读取;媒体输入 →media技能。 - 受限内容(社交媒体、付费文章) → 由
web技能(agent-reach/Jina)代为读取;不登录、不破解——如无法读取则告知用户。 - 当报告/报告文件(任何
.report.docx):按paper技能验证——pdfinfo+pdftotext,不虚构。 - 媒体技能需要按会话获取 → 参见
media技能(获取部分)或scripts/fetch-session.sh --list。 - 本地优先:本地文件优先使用本地工具。Web/API 需要连接;若离线则仅使用实际可用的本地/缓存资源或用户提供的资源,并说明无法访问的部分。
- 始终报告已写入的文件(名称 + 路径)——不静默处理。
流程符号
在下图中,▸ 表示移交给下一步;→ 表示流程继续;方括号描述来源或结果类型。这些是流程符号,不是来源标签或输出格式。
常见协作流程
PDF扫描件 ▸ doc 技能 ▸ 文本/表格 ▸ paper 技能 ▸ 报告
网页/社交 URL ▸ web 技能 ▸ 文本 ▸ paper 技能(如需要报告)
视频 URL/文件 ▸ media 技能 ▸ 摘要 + 帧 ▸ paper 技能(如需要报告)
SRT/mm:ss ▸ media 技能 ▸ 剪辑 ▸ 拼接