前言¶
調研或寫文檔時，材料往往散落在網頁、PDF、圖片、音頻和 YouTube 鏈接裏。常見做法是讓 Agent 逐個打開鏈接或手寫提取腳本，類型一變就要換一套流程。下面介紹 SkillHub 上的 summarize data file（座標 @user_a71e4ceb/summarize-skill-02）：它把 summarize 命令行工具的能力寫進 Agent Skill，讓助手按固定步驟調用 CLI，對 URL 或本地路徑做摘要。
這是什麼¶
summarize data file 是社區來源（community）的 Agent Skill，版本 1.0.0，分類爲 knowledge-management，由發佈者 user_a71e4ceb 維護。Skill 內嵌的說明指向 summarize CLI：用於快速摘要 URL、本地文件和 YouTube 鏈接；支持的輸入類型在官方簡介中寫明爲 web、PDFs、images、audio、YouTube。
SkillHub 頁面標註標籤 requires_api_key=true：實際調用模型時需要對應雲廠商的 API Key（見下文「模型與密鑰」）。
核心功能¶
依據 Skill 包內的 SKILL.md，可覈實的能力包括：
- URL 摘要：對網頁地址執行摘要，可選
--extract-only僅提取正文（僅 URL）。 - 本地文件摘要：對本地路徑（如 PDF）執行摘要。
- YouTube：對
youtu.be等鏈接摘要，可使用--youtube auto；若配置了APIFY_API_TOKEN，可在需要時走 Apify 回退。 - 輸出與長度：
--length支持short|medium|long|xl|xxl或字符數；--json輸出機器可讀結果；--max-output-tokens限制生成長度。 - 抓取回退：
--firecrawl auto|off|always，配合FIRECRAWL_API_KEY處理難以直接抓取的站點。 - 可選配置：
~/.summarize/config.json可設置默認模型等。
運行環境要求：系統 PATH 中需有 summarize 可執行文件。Skill 元數據給出的安裝方式爲 Homebrew：
brew install steipete/tap/summarize
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝文檔 檢查並安裝：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（文檔推薦）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝 summarize CLI¶
brew install steipete/tap/summarize
非 macOS 或未使用 Homebrew 的環境，需自行從 summarize.sh 獲取與平臺匹配的安裝方式；Skill 包內僅列出上述 brew 公式。
3. 將 Skill 裝到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時通過 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。
Cursor 示例：
skillhub install @user_a71e4ceb/summarize-skill-02 --dir ~/.cursor/skills/
Claude Code 示例：
skillhub install @user_a71e4ceb/summarize-skill-02 --dir ~/.claude/skills/
Codex 示例（用戶級或項目級二選一）：
skillhub install @user_a71e4ceb/summarize-skill-02 --dir ~/.codex/skills/
也可按 SkillHub 頁面提示，讓 AI 閱讀 https://skillhub.cn/install/skillhub.md 後安裝 @user_a71e4ceb/summarize-skill-02。
安裝完成後，按你所用客戶端的要求重啓或刷新 Skill 列表。
4. 模型與密鑰¶
調用前爲所選提供商設置環境變量（摘自 Skill 說明）：
- OpenAI：
OPENAI_API_KEY - Anthropic：
ANTHROPIC_API_KEY - xAI：
XAI_API_KEY - Google：
GEMINI_API_KEY（別名：GOOGLE_GENERATIVE_AI_API_KEY、GOOGLE_API_KEY）
未指定模型時，CLI 默認使用 google/gemini-3-flash-preview。可選服務密鑰：FIRECRAWL_API_KEY、APIFY_API_TOKEN（YouTube 回退）。
典型用法¶
以下命令來自 Skill 包內 Quick start，可直接在終端驗證 CLI；Agent 啓用本 Skill 後應引導你或代爲執行同類調用。
摘要網頁：
summarize "https://example.com" --model google/gemini-3-flash-preview
摘要本地 PDF：
summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
摘要 YouTube（自動選擇處理方式）：
summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
需要結構化輸出時：
summarize "https://example.com" --json --length medium
長期默認模型可寫入 ~/.summarize/config.json：
{ "model": "openai/gpt-5.2" }
適用場景與注意¶
適合誰：需要把多種外部資料（網頁、文檔、音視頻、YouTube）快速變成可讀摘要的開發者；希望 Agent 不要臨時拼湊爬蟲，而是走成熟的 summarize 工具鏈時。
限制與注意：
- 依賴本機 CLI：Skill 不會替代安裝
summarize；容器或遠程 Agent 環境需自行保證二進制可用。 - API Key：標籤
requires_api_key=true與文檔中的多廠商密鑰要求一致；未配置密鑰時摘要會失敗。 - 平臺安裝：Skill 元數據僅聲明 brew 安裝路徑；Linux 用戶需對照官網自行安裝，文中不臆測包名。
- SkillHub 數據：截至覈對，SkillHub 展示評分爲 100000，下載 986 次，安裝計數 0（以頁面與 API 元數據爲準，會隨時間變化）。
結尾¶
summarize data file 把 summarize CLI 的摘要能力封裝成標準 Skill：統一入口處理 URL 與本地文件，並通過參數控制長度、JSON 輸出與抓取回退。若你在 Cursor 等客戶端做知識整理，可先裝好 CLI 與 API Key，再按座標安裝 Skill。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_a71e4ceb/summarize-skill-02
- API 元數據地址：https://api.skillhub.cn/user_a71e4ceb/summarize-skill-02
- summarize 項目主頁：https://summarize.sh
