Agent Skills
返回列表
Excel 工作簿转 Markdown 与内容分析

Excel 工作簿转 Markdown 与内容分析

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/convert-excel-to-md。

技能介绍

为什么不应直接解析 .xlsx 文件

许多开发者在处理 Excel 文件时,第一反应是直接读取 xlsx 的内容。然而,.xlsx 并不是简单的文本文件,而是包含复杂 XML 结构的 zip 压缩包。直接用文本解析器读取不仅会遇到乱码和结构混乱的问题,还极容易遗漏其中包含的嵌入式图片、合并单元格等关键信息。更现实的问题是,当业务方丢过来一个包含多个工作簿的文件夹,要求你提取所有数据进行总结分析时,手工逐个解析不仅耗时而且容易出错。

核心工作流

本技能的核心职责是将所有 .xlsx 数据转化为纯净、对齐且可供解析的 Markdown 格式。

  • Sheet 级转换:脚本底层利用 markitdown 将 .xlsx 中的每个工作表独立渲染为一个 Markdown 二级标题和对应的表格。
  • 图片抽取:原生转换器通常无法处理工作簿内的真实嵌入图片。本工作流额外提取照片形式的位图,将其写入 workbook/img/ 目录下,并提供其在工作表中的关联位置。
  • 批量与递归处理:当面对包含多个工作簿的文件夹时,可直接对整个目录发起请求。脚本会在每个源文件旁生成对应的 workbook/ 输出文件夹;加入 --recursive 参数即可一并处理子目录。
  • 数据下游分析:脚本的使命仅限于高效准确地输出 Markdown 和图像。获取到结构化的 .md 文件后,对接 LLM 即可针对用户需求进行摘要、表格分析或特定数值提取。

边界与限制

使用本方案前,请务必确认你的输入数据符合以下约束:

  • 仅支持 .xlsx:对于陈旧的 .xls 格式,系统会直接报错并拒绝执行,请让用户另存为 .xlsx。
  • 原生图表不可图片化:技能会抽取嵌入的真实照片,但无法直接渲染 Excel 原生图表对象。如果场景需要将图表生成为可视图像,该轻量脚本无法满足要求,需使用 Excel 等重型工具。
  • 混合文件类型调度:如果接收目录中混杂了 PDF、Word 和 Excel,技能仅会转换 .xlsx 文件。此时 Agent 需并行调度 PDF 与 Word 的同级转换技能,而不会默默跳过这些文档。
  • 输出路径受限:默认输出文件夹创建于源 .xlsx 所在目录。仅当用户明确指定输出位置时,才会启用 -o 参数进行重定向。

使用场景

  • 销售拿到季度业绩.xlsx,需要总结各区域销售额并抽取表格数据
  • 资料文件夹有一批工作簿,要统一转成 Markdown 并保留每份的嵌入图片
  • 审计同事需要从复杂报表中定位符合条件行,转成 Markdown 后由模型提取数值
  • 用户误传 legacy .xls,需要先说明不支持并引导其另存为 .xlsx

适合人员

  • 运营人员:每周要把多份业务表格汇入同一份在线报告
  • 数据分析师:需要从多个工作簿中提取指标并写成可追溯的调查记录
  • 后端工程师:在文档管线中要把 xlsx 源码稳定转换为 Markdown 再分析
  • 内容编辑:准备技术文章时需要用工作簿中的嵌入图片补充说明