SuperAPI AI 工具集

office-document

办公与效率

查看项目

更新于 10-16 02:44

技能介绍

用途

office-document 是一个路由决策技能,而不是文档引擎的替代品。它的作用是把用户的可编辑文档创建或修改任务,路由到合适的官方 Hermes 文档技能。官方 Hermes 技能是彼此独立的技能,本技能负责判断该用哪一个。

主要能力

根据用户任务类型,将请求映射到对应的 Hermes 技能:

  • 创建、读取、编辑、套用模板或审阅 Word .docx:使用 docx 技能
  • 创建、读取或编辑 Excel .xlsx / CSV:使用 xlsx 技能
  • 创建、读取或编辑可编辑的 PowerPoint .pptx:使用 powerpoint 技能
  • 创建、读取、合并、填写、加密或以其他方式操作 PDF:使用 pdf 技能
  • 只读提取或摘要:不要路由到这里,直接读取文件即可
  • 不需要可编辑 .pptx 的视觉演示:使用 Starchild slide-creator

决策规则

  1. 先判断用户需要的是可编辑输出,还是只需要信息。只读不属于文档生产任务,不要仅仅为了提取或摘要文件内容就安装或调用文档技能。
  2. 从上表中精确选择一个格式专用的 Hermes 技能。
  3. 对于混合请求,将每个产物路由到各自格式专用的技能;不要用 powerpoint 处理 PDF,也不要用 docx 处理通用演示。
  4. 对于扫描件或纯图片 PDF,先使用或改用 Hermes ocr-and-documents,而不是 pdf;PDF 技能无法凭空补出缺失的文本层。
  5. 任何编辑或创建之后,遵循所选技能自身的验证步骤。没有回读以及(在适用时)渲染/视觉检查,就不要声称格式保真。

使用方式

这些是来自 NousResearch/hermes-agent 的官方技能,不是名称相似的社区技能。

通过 Skills CLI 安装时,只安装当前任务所需的那一个技能,不要预先安装所有格式专用技能。使用匹配的命令:

  • DOCX 任务:npx skills add NousResearch/hermes-agent --skill docx
  • XLSX/CSV 任务:npx skills add NousResearch/hermes-agent --skill xlsx
  • 可编辑 PPTX 任务:npx skills add NousResearch/hermes-agent --skill powerpoint
  • PDF 任务:npx skills add NousResearch/hermes-agent --skill pdf
  • 扫描件或纯图片 PDF:仅在确实需要 OCR 时安装 ocr-and-documents:npx skills add NousResearch/hermes-agent --skill ocr-and-documents

除非用户明确要求某个同名社区包,否则不要用名称相似的社区包替代。安装后,确认所选技能的 SKILL.md 存在,并使用它自己的脚本和验证命令。

官方来源映射

上游来源路径为:

  • https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/docx
  • https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/xlsx
  • https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/powerpoint
  • https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/pdf
  • https://github.com/NousResearch/hermes-agent/tree/main/skills/productivity/ocr-and-documents

Hermes docx 技能使用 python-docx 辅助工具和包健康检查;xlsx 使用 openpyxl;powerpoint 使用 python-pptx;pdf 使用 pypdf、reportlab 和 pdfplumber。这些实现细节描述的是官方技能,不应替换为猜测的本地命令。

适用场景

  • 用户要求创建、编辑、套用模板或审阅 Word 文档
  • 用户要求创建、读取或编辑 Excel 表格或 CSV
  • 用户要求创建、读取或编辑可编辑的 PowerPoint 演示文稿
  • 用户要求创建、读取、合并、填写、加密或操作 PDF
  • 用户提出混合格式的文档生产请求,需要分别路由

限制

  • 本技能只做路由,不替代文档引擎本身
  • 只读提取或摘要不应路由到此技能
  • 扫描件或纯图片 PDF 需要先使用 ocr-and-documents,PDF 技能无法补出缺失的文本层
  • 未提供收费、价格、平台或效果方面的信息
  • 未提供除上述官方来源映射之外的更多实现细节