前言¶
调研或写文档时，材料往往散落在网页、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
