前言¶

調研資料、復盤會議、跟進技術視頻時，輸入往往是鏈接、PDF、錄音或 YouTube，而不是一段可直接粘貼的正文。若只靠模型「憑印象概括」，容易漏掉細節，也難以覈對來源。更穩妥的做法是先把內容抽取或轉寫，再生成摘要。

下面介紹的 summary 是 SkillHub 上的社區 Skill（座標 @user_b7e5c773/skill，當前版本 1.0.0）。它把 Agent 的工作流對齊到 summarize 命令行工具：由 CLI 負責網頁、PDF、圖片、音頻、YouTube 等輸入的提取與摘要，Agent 按 Skill 約定調用命令並處理輸出，而不是手寫一套臨時腳本。

這是什麼¶

summary 屬於 SkillHub 分類 knowledge-management（子類「摘要總結」），發佈者爲 user_b7e5c773，來源標註爲 community。

官方簡介（與頁面一致）：

Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).

Skill 標籤 requires_api_key=true：實際跑摘要或部分媒體能力時，通常需要爲 summarize 或其調用的模型、轉寫服務配置 API Key；Skill 側要求 Agent 通過 summarize status 等方式檢查就緒情況，且不要打印或泄露密鑰值。

核心功能¶

依據 SkillHub 公示的簡介與 summarize 項目文檔，該 Skill 覆蓋的能力可歸納爲：

1. 網頁與遠程文檔：對 http/https 鏈接做可讀性提取並生成摘要。
2. 本地或遠程 PDF：路徑或 URL 形式的 PDF 輸入。
3. 圖片：本地圖片文件參與提取與摘要流程。
4. 音頻：本地錄音等文件，可走轉寫再摘要。
5. YouTube：視頻鏈接，優先字幕/轉寫路徑，再進入摘要。
6. 僅提取不摘要：通過 --extract 等選項拿到清洗後的 Markdown 或文本，供後續人工或 Agent 處理。

Skill 頁面 overviewMd 爲空，未提供額外長文說明；能力邊界以簡介中的媒體類型與 summarize CLI 行爲爲準。

安裝與啓用¶

在 SkillHub 安裝 Skill¶

SkillHub 詳情頁給出的安裝說明是：先閱讀安裝指南，再安裝指定座標。

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_b7e5c773/skill。

若已安裝 skillhub CLI，可按指南將 Skill 裝進當前 Agent 的 skills 目錄（須使用 --dir，否則默認目錄可能不被 Agent 加載）。示例：

command -v skillhub && skillhub --version
skillhub install @user_b7e5c773/skill --dir ~/.cursor/skills/

Cursor 常用路徑爲 ~/.cursor/skills/；Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/。具體以你使用的客戶端爲準，詳見 SkillHub 安裝文檔。

也可在 SkillHub 頁面下載 skill-1.0.0 Zip 包，解壓到對應 skills 目錄後重啓或刷新 Agent。

安裝 summarize CLI（運行依賴）¶

Skill 描述的是「用 summarize CLI」完成任務，因此本機需要可執行的 summarize 命令。官方安裝文檔要求 Node 24+，跨平臺可用 npm：

npm i -g @steipete/summarize

macOS / Linux 也可選 Homebrew：

brew install summarize

安裝後自檢：

summarize --version
summarize status

純網頁摘要可不裝額外系統工具；YouTube 幻燈片、部分下載轉寫路徑等可能依賴 ffmpeg、yt-dlp、tesseract 等可選組件，缺什麼以命令報錯爲準再補裝。

API Key 與配置¶

SkillHub 標記 requires_api_key=true。summarize 在需要 LLM 摘要或雲轉寫時，會讀取環境變量或 ~/.summarize/config.json（優先級：CLI 參數 > 環境變量 > 配置文件 > 默認）。常見變量包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY 等；媒體轉寫還可配置 GROQ_API_KEY 等。配置方式見 summarize 安裝與 Provider 說明。

典型用法¶

啓用 summary 後，Agent 應把 summarize 當作唯一推薦入口：先 summarize --help / summarize status 確認環境，再按任務選最窄命令。下列示例與 Skill 簡介中的輸入類型一致，可在終端直接復現（需已安裝 CLI 並完成 Key 配置）。

網頁或遠程 PDF：

summarize "https://example.com/article"
summarize "https://example.com/report.pdf" --length short

本地 PDF、音頻：

summarize "./report.pdf"
summarize "./recording.m4a"

YouTube：

summarize "https://youtu.be/VIDEO_ID"

只提取正文、不調用摘要模型：

summarize "https://example.com/article" --extract --format md
summarize "./report.pdf" --extract --format md

給自動化或下游 Agent 解析的 JSON 輸出：

summarize "https://example.com" --json --metrics off > result.json

遠程頁面或媒體較慢時，可爲單次任務加超時，例如 --timeout 2m。涉及機密材料時，應先確認允許的模型與轉寫提供方，再執行命令。

適用場景與注意¶

適合誰

• 經常把「一個 URL / 一份 PDF / 一段錄音 / 一個視頻」交給 Agent 做結構化摘要或摘錄的開發者。
• 希望 Agent 行爲穩定、可審計：命令、退出碼、stdout/stderr 分離清晰，便於腳本化。

限制與注意

• Skill 依賴本機 summarize 與網絡/Key；無 Key 時部分路徑只能 --extract 或會失敗，需用 summarize status 排查。
• YouTube、幻燈片、說話人分離等高級能力可能額外依賴 yt-dlp、雲轉寫 Key 或本地 whisper.cpp，與「僅摘要普通網頁」的依賴不同。
• SkillHub 統計（截至頁面展示）：約 5786 次下載；安裝後若行爲異常，應覈對 Zip 包內容與座標是否爲 @user_b7e5c773/skill v1.0.0。

結尾¶

summary 的價值在於：把「多形態輸入 → 提取/轉寫 → 摘要」收斂到一條 CLI 與一套 Agent 約定，減少每次臨時寫爬蟲或轉寫腳本的成本。官方 Skill 頁與 API 入口：

• SkillHub：https://www.skillhub.cn/skills/user_b7e5c773/skill
• https://api.skillhub.cn/user_b7e5c773/skill

summarize CLI 安裝與命令細節：https://summarize.sh/docs/install.html