英文版:
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技能(fetch 部分)或scripts/fetch-session.sh --list。 - 本地優先:對於本地檔案優先使用本地工具。網頁/API 需要連線;若離線則僅使用真正可用的本地/快取來源或使用者提供的來源,並說明無法存取的部分。
- 始終回報已寫入的檔案(名稱 + 路徑)— 不要沉默。
流程符號
在下圖中,▸ 表示移交至下一步;→ 表示流程繼續;方括號描述來源或結果的類型。這些是流程符號,不是來源標籤或輸出格式。
常見協作流程
PDF 掃描 ▸ doc 技能 ▸ 文字/表格 ▸ paper 技能 ▸ 報告
網頁/社交媒體 URL ▸ web 技能 ▸ 文字 ▸ paper 技能(如需報告)
影片 URL/檔案 ▸ media 技能 ▸ 摘要 + 幀 ▸ paper 技能(如需報告)
SRT/mm:ss ▸ media 技能 ▸ 修剪 ▸ 串接