前言¶
在 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
