前言¶
项目资料、会议记录和零散笔记往往堆在同一目录里，格式也不统一。人工逐个打开、归类、写目录，成本高，且很难在事后快速检索。若希望由 Agent 按统一流程处理一批本地文档，而不是每次手写提示词拼凑步骤，可以把「扫描—摘要—分类—索引—重组」封装成 Skill。下面介绍 SkillHub 上的 文档整理归档SKILL（@user_7f87e8c5/songsir2026），它面向知识库与文件归档场景，在对话中通过触发词即可启用。
这是什么¶
文档整理归档SKILL 是社区来源（community）的知识管理类 Skill，当前版本 1.0.0，发布坐标为 @user_7f87e8c5/songsir2026，SkillHub 分类为 knowledge-management。官方简介将其定位为：文档归档与整理能力——扫描指定目录中的文档，提取摘要，自动分类，生成索引目录，并重组文件结构；支持 Markdown、TXT、PDF、DOCX、PPTX 等混合格式。标签标明 requires_api_key=false，即不依赖额外 API Key 配置（具体仍取决于你使用的 Agent 与本地环境）。
维护与展示信息见 SkillHub 页面（发布者 user_7f87e8c5，作者展示为「宋宋先生」）。截至页面与 API 资料，评分为 100000，下载约 2696 次。
核心功能¶
以下能力均来自官方简介，未在资料中出现的细节不作延伸：
- 目录扫描：对目标路径下的文档进行批量扫描。
- 摘要提取：从各文件中提炼可用于归档与检索的摘要信息。
- 自动分类：按内容或规则将文档归入类别，减轻手工分拣。
- 索引目录：生成可浏览的文档索引/目录结构。
- 结构重组：在分类与索引基础上调整或输出重组后的文件布局。
适用对话意图的官方说明：当需要整理文档、归档知识库、批量文件分类、生成文档索引时使用。常见触发词包括：整理文档、知识库整理、文档归档、文件分类、生成目录、文档索引、整理笔记、批量整理、归档整理。
安装与启用¶
本 Skill 基于通用 SKILL.md 格式。SkillHub 页面建议：根据 SkillHub 安装说明 安装 @user_7f87e8c5/songsir2026。也可将安装提示发给 AI，让其按同一文档完成安装。
1. 检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）或仅 CLI：
# 完整安装（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. 安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被 Agent 加载。官方文档给出的常见路径如下（按你实际使用的客户端选择）：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装命令形式为：
skillhub install user_7f87e8c5/songsir2026 --dir <你的 skills 目录>
也可用搜索确认坐标后再安装：
skillhub search songsir2026
skillhub install user_7f87e8c5/songsir2026 --dir ~/.cursor/skills/
（将最后一行路径替换为你环境中的实际目录。）安装后若 Agent 未立即识别新 Skill，需按所用客户端说明刷新或重启后再试。
典型用法¶
官方资料未提供单独的 CLI 子命令或固定配置文件示例；使用方式是在已启用该 Skill 的 Agent 对话中，说明要整理的目录与目标（例如归档知识库、生成索引、按主题分类），并采用上述触发词之一。例如：
- 「请用文档归档能力，扫描
~/Documents/notes，按主题分类并生成文档索引。」 - 「知识库整理：把当前项目下的 PDF 和 Markdown 批量整理，输出目录结构。」
Agent 将按 Skill 内定义的流程执行扫描、摘要、分类、索引与结构重组；具体输出路径与命名规则以 Skill 包内 SKILL.md 及 Agent 执行结果为准，本文不臆造步骤参数。
适用场景与注意¶
适合谁
- 本地或项目内混有多种办公与笔记格式，需要一次性或周期性归档。
- 希望建立可检索的索引目录，而不是只在文件夹里按日期堆文件。
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的环境中工作，并愿意通过 SkillHub 管理技能包。
注意
- 大体积 PDF、扫描件或损坏文件可能影响摘要与分类质量；执行前宜备份原目录。
- 混合格式解析依赖 Agent 与 Skill 实现，官方简介未承诺对每一种复杂版式的完美支持。
- 下载次数与评分来自 SkillHub 展示，会随时间变化；以 SkillHub 技能页 为准。
结尾¶
文档整理归档SKILL 把「扫描、摘要、分类、索引、重组」串成一条可复用的 Agent 工作流，适合知识库整理与批量归档。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_7f87e8c5/songsir2026
- API 资料：https://api.skillhub.cn/user_7f87e8c5/songsir2026
- 安装文档：https://skillhub.cn/install/skillhub.md
