Communitygithub.com

orchestrator — 输入编排器

接收输入,识别类型,转发给仓库中其他技能——文档、媒体、论文、网页——并在撰写报告前强制进行需求确认。当不确定哪个技能应处理当前输入,或需要多技能协作流程时使用。

orchestrator — 输入编排器 是什么?

orchestrator 是一个轻量的自写技能,本身不包含独立代码,核心职责是接收用户输入、判断其类型(如 PDF/DOCX/XLSX、视频/音频/图片、网页/社交/搜索、报告需求或图表需求),然后根据预定义的路由表将输入转发给仓库中对应的专业技能——`doc`、`media`、`paper`、`web`、`diagram`。除了路由转发,orchestrator 还在用户要求生成或重写报告时,强制执行一个最多4个问题的需求确认步骤,涵盖报告类型、目标读者、输出语言与格式、来源范围,避免不完整或模糊的需求导致后期返工。该技能支持 Claude Code、Cursor、Codex 等 AI 代理平台,采用本地优先原则,优先使用本地工具处理本地文件,仅在需要时调用外部 API(如 Jina、agent-reach、exa),并在离线时限制只使用实际可用的本地/缓存数据。输出文件遵循固定的后缀命名规则(如 `.extract.md`、`.digest.md`、`.report.md`),且始终报告写入的文件路径。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tpc-pascal/agent-skills/tree/HEAD/skills/research/orchestrator

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

英文版:SKILL.en.md

orchestrator — 输入编排器 是做什么的?

轻量自写技能:无独立代码——接收输入,识别类型,转发至正确的处理器。

仓库中的技能

技能使用场景
docPDF/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 的某一种类型撰写报告。

编排规则

  1. 输入语言提示——使用用户使用的语言回复。
  2. 明确输出文件:<原始文件名>.<后缀>。不覆盖已有文件。后缀:文档 .extract.md|.txt|.csv,摘要 .digest.md,字幕 .srt|.vtt,剪辑 .clip-<t1>-<t2>.mp4,报告 .report.md|.report.docx。
  3. 不导入输入——仅处理真实存在的文件,输出放置在/覆盖文件中;不自行添加文件。
  4. 网页/社交/搜索输入 → web 技能(Jina/agent-reach/exa)先读取;媒体输入 → media 技能。
  5. 受限内容(社交媒体、付费文章) → 由 web 技能(agent-reach/Jina)代为读取;不登录、不破解——如无法读取则告知用户。
  6. 当报告/报告文件(任何 .report.docx):按 paper 技能验证——pdfinfo + pdftotext,不虚构。
  7. 媒体技能需要按会话获取 → 参见 media 技能(获取部分)或 scripts/fetch-session.sh --list。
  8. 本地优先:本地文件优先使用本地工具。Web/API 需要连接;若离线则仅使用实际可用的本地/缓存资源或用户提供的资源,并说明无法访问的部分。
  9. 始终报告已写入的文件(名称 + 路径)——不静默处理。

流程符号

在下图中,▸ 表示移交给下一步;→ 表示流程继续;方括号描述来源或结果类型。这些是流程符号,不是来源标签或输出格式。

常见协作流程

PDF扫描件 ▸ doc 技能 ▸ 文本/表格 ▸ paper 技能 ▸ 报告
网页/社交 URL ▸ web 技能 ▸ 文本 ▸ paper 技能(如需要报告)
视频 URL/文件 ▸ media 技能 ▸ 摘要 + 帧 ▸ paper 技能(如需要报告)
SRT/mm:ss ▸ media 技能 ▸ 剪辑 ▸ 拼接

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

tpc-pascal/agent-skills

Vẽ sơ đồ và biểu đồ đẹp cho báo cáo — flowchart/sequence/class/state/ER/gantt bằng Mermaid (kroki.io, PNG), biểu đồ cột/tròn/line bằng matplotlib (uv), output `<tên>.diagram.png` cạnh nguồn để nhúng vào `.report.docx`. Dùng khi báo cáo cần sơ đồ thay cho ASCII, cần biểu đồ dữ liệu, hoặc user yêu cầu "sơ đồ đẹp".

tpc-pascal/agent-skills

Trích xuất và chuyển đổi tài liệu PDF/DOCX/XLSX — lấy text layer (pdftotext), OCR ảnh scan (pdftoppm + tesseract), chuyển markdown (docling), XLSX → CSV (libreoffice headless), ghép/tách/đảo trang (qpdf/pdftk), kiểm tra output bằng pdfinfo + pdftotext. Dùng khi đưa tài liệu và muốn lấy text, OCR bản scan, chuyển định dạng, tách/ghép/trang, hoặc xác minh nội dung đã trích.

tpc-pascal/agent-skills

Xử lý media — ffprobe thông số, ffmpeg cắt/ghép/transcode/GIF, trích frame, tách audio, phụ đề (shift/convert/burn), timecode SMPTE, phát hiện shot, OCR frame/ảnh, tải từ URL (yt-dlp), nhạc (thể loại/mood/BPM/lyrics). Dùng khi đưa video/audio/ảnh/URL media và muốn tóm tắt nội dung, trích text, cắt ghép, làm phụ đề, lấy khung hình, hoặc tải xuống.

tpc-pascal/agent-skills

Viết báo cáo theo một trong hai dạng: chuẩn quốc tế hoặc phổ biến tại Việt Nam. Tổng hợp nguồn có trích dẫn, giữ báo cáo chính gọn và tách dữ liệu hỗ trợ khi cần; xuất `.report.md` hoặc `.report.docx`.

相关技能