Read XLSX

读取 Microsoft Excel (.xlsx / .xls) 电子表格的内容,并以结构化方式(Markdown 表格/CSV/摘要)返回。 当用户需要查看表格数据、分析特定 Sheet 或提取单元格内容时使用。

gagaa-hue Updated

File contents

read-xlsx Skill

触发条件

用户输入 /read-xlsx <路径> 时,本 skill 生效。

执行流程

  1. 检查依赖:使用 Bash 检查 pythonpython3 是否可用,以及 openpyxl 库是否已安装。

    • 若未安装,自动运行:
      pip install openpyxl
      
  2. 验证文件:确认路径存在且以 .xlsx.xls 结尾。

  3. 提取内容:运行以下 Python 脚本获取工作表列表和指定 Sheet 的数据:

    import openpyxl
    wb = openpyxl.load_workbook("<路径>")
    print("Sheets:", wb.sheetnames)
    ws = wb["<Sheet名>"]
    for row in ws.iter_rows(values_only=True):
        print(row)
    
  4. 数据呈现

    • 如果表格较小(< 50 行),直接输出完整的 Markdown 表格。
    • 如果表格较大,输出前 20 行 + 表头,并告知总行数和总列数,询问用户是否需要查看更多或筛选特定内容。
  5. 支持 .xls 格式

    • 如果是 .xls 文件且 openpyxl 无法打开,自动安装 xlrd 并使用其读取。

输出要求

  • 始终使用中文回复用户。
  • 先列出所有可用的 Sheet 名称。
  • 用 Markdown 表格展示数据,保持对齐。
  • 若用户未指定 Sheet,默认读取第一个 Sheet。
  • 若提取失败,给出具体错误原因。

gagaa-hue/ashuo-claude-skills/tree/main/read-xlsx commit 4ddb863777

Frequently asked questions

npx skillmds@latest add gagaa-hue/read-xlsx