Communitygithub.com

tpc-pascal/agent-skills

協調器 — 接收輸入、判斷類型、轉發給倉庫內的其他技能(文檔、媒體、論文、網路)— 並在撰寫報告前強制執行提問環節。適用於不確定哪個技能能處理當前輸入,或需要多技能協同流程時。

agent-skills 是什麼?

這個技能是一個輕量級協調器,本身不包含任何獨立程式碼,而是根據輸入類型(PDF/DOCX/XLSX 文檔、影片/音訊/圖片媒體、網頁/社交媒體/搜尋結果)將任務轉發給倉庫內對應的技能(doc、media、paper、web、diagram)。它的核心價值在於:當使用者不清楚該用哪個技能處理特定輸入時,由 orchestrator 自動路由;當使用者要求撰寫或改寫報告時,它會強制執行一個最多 4 題的提問環節,確認報告類型(國際標準或越南通俗版)、目的與讀者、輸出格式與語言、以及來源範圍,避免假設錯誤導致報告偏離需求。支援的平台包括 Claude Code、Cursor、Codex 等,主要透過 npx skills add 命令安裝。協調流程遵循本地優先原則,對於鎖定的內容(如付費文章或社交媒體貼文)會嘗試透過 web 技能的 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 技能(fetch 部分)或 scripts/fetch-session.sh --list。
  8. 本地優先:對於本地檔案優先使用本地工具。網頁/API 需要連線;若離線則僅使用真正可用的本地/快取來源或使用者提供的來源,並說明無法存取的部分。
  9. 始終回報已寫入的檔案(名稱 + 路徑)— 不要沉默。

流程符號

在下圖中,▸ 表示移交至下一步;→ 表示流程繼續;方括號描述來源或結果的類型。這些是流程符號,不是來源標籤或輸出格式。

常見協作流程

PDF 掃描 ▸ doc 技能 ▸ 文字/表格 ▸ paper 技能 ▸ 報告
網頁/社交媒體 URL ▸ web 技能 ▸ 文字 ▸ paper 技能(如需報告)
影片 URL/檔案 ▸ media 技能 ▸ 摘要 + 幀 ▸ paper 技能(如需報告)
SRT/mm:ss ▸ media 技能 ▸ 修剪 ▸ 串接

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能