全能本地文档处理专家:纯本地 Office 文档的 Agent Skill

前言

在 Agent 里处理 xlsx、docx、pdf 时,常见做法是让用户自己装一堆库、写脚本,或把文件交给在线转换服务。前者步骤多、环境难统一;后者往往要 API Key,且文档会离开本机。若你希望对话里直接完成创建、编辑、转换和简单分析,又坚持数据不出本地、不配置密钥,需要一个把能力写进 Skill、由 Agent 按规范调 Python 的方案。下面介绍 SkillHub 上的「全能本地文档处理专家」。

这是什么

「全能本地文档处理专家」是 SkillHub 社区 Skill,坐标为 @user_734b3090/office-toolkit-local,当前版本 1.0.0,分类为 office-efficiency,发布者为 user_734b3090(SkillHub 页面标注作者为李杰)。Skill 标签标明 requires_api_key=false,即不依赖外部 API Key。

一句话定位:在 Agent 中通过自然语言触发,对 xlsx / docx / pdf / pptx / csv / md 等格式进行创建、编辑、转换与分析,执行侧为纯本地 Python。

官方入口:

核心功能

以下能力均来自 SkillHub 简介与页面描述,未单独展开的实现细节以安装后的 SKILL.md 为准。

方向 说明
表格与数据 Excel(xlsx)公式、图表;csv 处理;数据分析与报告类任务
文稿 Word(docx)创建与编辑;中文排版与模板
PDF 合并、拆分、水印、加密等常见操作
演示与标记 PPT(pptx)相关处理;Markdown(md)格式转换
工程特性 批量处理;全程本地、零 API Key

便于 Agent 匹配的触发词包括:文档、Excel、Word、PDF、PPT、表格、报告、转换、合并、提取、排版、批量,以及 xlsx、docx、pptx、csv、watermark、encrypt、chart、formula、template、office 等。

安装与启用

SkillHub 推荐两种方式:用 CLI 安装,或把安装提示词发给当前 AI,让其按官方安装文档操作。

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

安装说明全文:https://skillhub.cn/install/skillhub.md。

2、安装本 Skill

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能无法加载。

skillhub install @user_734b3090/office-toolkit-local --dir <skills 目录>

常用路径(来自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

也可直接向 Agent 发送 SkillHub 页面给出的提示词,让其根据 https://skillhub.cn/install/skillhub.md 安装 @user_734b3090/office-toolkit-local。

安装完成后,按你所用客户端要求重启或刷新 Agent,使 Skill 生效。

典型用法

公开页面未附带独立命令行教程;实际行为由 Skill 包内的 SKILL.md 与附带脚本定义。在启用 Skill 后,可按简介中的场景用自然语言描述任务,并带上上述触发词,例如:

  1. 说明输入输出路径与格式(如「把目录下多个 pdf 合并为一个文件」)。
  2. 对 Word,写明是否需要模板或中文排版要求。
  3. 对 Excel,写明公式、图表或汇总报告需求。
  4. 对 PDF,写明合并、拆分、水印或加密等具体操作。

Agent 应在本地 Python 环境中执行 Skill 规定的步骤;若缺少依赖,需按 SKILL.md 或安装日志在本地补齐,而非配置云端密钥。

适用场景与注意

适合谁

  • 需要在 Cursor、Claude Code、Codex 等支持 Skills 的客户端里处理 Office 类文件,且希望文档不经过第三方 API 的开发者或办公自动化用户。
  • 需要批量转换、合并、提取或简单分析报告,又不想每次手写 openpyxl、python-docx、PyPDF2 等脚本的场景。

需要注意

  • 能力边界以 Skill 简介为准;复杂排版、宏、受保护文档等是否支持,需以安装后的 Skill 文档为准,本文无法核实未公开的细节。
  • 纯本地意味着本机需具备相应 Python 依赖与足够磁盘、算力;大批量文件应先小样本试跑。
  • SkillHub 抓取信息显示该 Skill 评分 100000、下载 5129 次(统计随平台更新而变化)。

结尾

「全能本地文档处理专家」把常见 Office 与 Markdown 操作收敛为一个 office-efficiency 类 Skill,强调本地 Python 与 零 API Key,适合在 Agent 对话里用触发词驱动文档流水线。安装与坐标以 SkillHub 为准:

https://www.skillhub.cn/skills/user_734b3090/office-toolkit-local

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜