前言¶
在 IDE 里读长文、翻 PDF 或打开外部链接时,常见做法是复制片段进对话,或自己先扫一遍再提问。前者容易丢上下文,后者耗时。若希望 Agent 在用户说「总结」「提炼要点」时,能按统一流程处理网页、PDF、Markdown、TXT 等输入并产出概览,需要一条明确的技能边界,而不是每次临时写提示词。
下面介绍 SkillHub 社区技能 Document Summarize(坐标 @user_7eecc4ea/summarize-new),说明其定位、能力与安装方式。
这是什么¶
Document Summarize 是面向「内容概览」场景的 Agent Skill,发布者为 user_7eecc4ea,来源为 community,分类为 knowledge-management,当前版本 1.0.0。官方页面标注 requires_api_key=false,即按 SkillHub 展示信息,该技能不依赖额外 API Key 配置项。
触发条件在简介中写得很直接:当用户要求「总结」「摘要」「提炼要点」「提取关键信息」,或提供 URL、文件路径并希望生成内容概览时,应使用本技能;支持网页(HTML)、PDF、Markdown、TXT 等格式。
核心功能¶
依据官方简介,可核实的能力如下。
- 意图识别:将「总结 / 摘要 / 要点 / 关键信息」类请求路由到同一套摘要流程。
- 多源输入:接受 URL(网页 HTML)或本地/工作区内的文件路径。
- 多格式:覆盖 HTML、PDF、Markdown、TXT 等常见文档形态,用于生成概览而非全文复述。
SkillHub 页面当前统计(以抓取资料为准):评分 100000,下载 1511 次,安装计数为 0;具体数字会随商店更新变化,写作时以 SkillHub 技能页 为准。
安装与启用¶
技能基于通用 SKILL.md 格式,通过 SkillHub CLI 安装到当前 Agent 的 skills 目录;装错目录时 Agent 可能无法加载,需按环境选对路径。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档 执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 Document Summarize¶
安装时必须用 --dir 指向当前使用的 Agent 的 skills 目录。官方安装说明中的通用形式如下:
skillhub install user_7eecc4ea/summarize-new --dir <skills 目录>
常用客户端 skills 路径(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可在对话中让 AI 按 https://skillhub.cn/install/skillhub.md 安装 @user_7eecc4ea/summarize-new;本质仍是把技能落到可被当前 Agent 识别的目录。
安装或更新技能后,若客户端要求重启或重新加载 skills,按该客户端说明操作。
典型用法¶
官方资料未给出单独的可执行脚本示例,用法与简介中的触发语一致,可在启用技能后直接复现下列对话模式。
- 纯意图:例如「请总结下面这段讨论的核心结论」「帮我提炼要点」——由技能接管摘要结构与粒度。
- 带 URL:提供可访问的网页地址,要求生成概览(输入为 HTML 页面)。
- 带文件路径:指向工作区或本机可读路径的 PDF、Markdown、TXT 等,要求摘要或关键信息提取。
具体读取网页、解析 PDF 的步骤写在技能自带的 SKILL.md 中;本文不展开未在官方页面摘录的实现细节。
适用场景与注意¶
适合谁:需要在 Cursor、Claude Code、Codex 等支持 Skills 的环境里,把「读长文档 → 出摘要」变成默认可用能力的开发者或写作者;分类 knowledge-management 也对应笔记、资料归档类工作流。
注意:
- 网页摘要依赖 URL 可访问性与客户端联网策略;本地 PDF/TXT 依赖路径正确且 Agent 有读取权限。
- 安装目录必须与当前 Agent 一致,否则会出现「已 install 但对话不触发」的情况。
- 评分与下载量来自 SkillHub 展示,不代表某种质量认证;是否满足合规、版权与隐私要求,需结合文档来源自行判断。
结尾¶
Document Summarize 把「总结、摘要、要点、关键信息」以及 URL/文件路径类请求收敛到一条技能路径,并声明支持 HTML、PDF、Markdown、TXT。若你已在用 SkillHub 管理技能,可用坐标 @user_7eecc4ea/summarize-new 安装到对应 skills 目录。
- SkillHub 页面:https://www.skillhub.cn/skills/user_7eecc4ea/summarize-new
- API/资源地址:https://api.skillhub.cn/user_7eecc4ea/summarize-new
- 安装说明:https://skillhub.cn/install/skillhub.md