agent-xlsx

AI代理读写xlsx文件的命令行工具

开发流程 批量处理数据自动生成文档 claude通用 ★ 4 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:agent-xlsx。
它的用途是:AI代理读写xlsx文件的命令行工具
完整的 Skill 内容见:https://321skill.com/skills/agent-xlsx-chrisarderne/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请创建book.xlsx文件,在A1:C1写入表头["姓名","年龄","城市"],并在A2:C3写入数据[["张三",28,"北京"],["李四",35,"上海"]]',它会自动调用agent-xlsx create创建文件,再调用agent-xlsx edit写入数据,最后用agent-xlsx read验证结果。

介绍

这个Skill解决了AI代理在读取和编辑Excel文件时效率低、消耗Token多的问题。在实际开发中,AI代理经常需要处理.xlsx格式的报表或数据,但直接使用Python库(如openpyxl)需要记住复杂的API,且输出格式不利于AI解析,导致Token浪费和错误率上升。

使用方式很简单,你只需要通过一条curl命令安装预编译二进制文件。之后通过自然语言指令让AI代理执行agent-xlsx createagent-xlsx readagent-xlsx edit等操作,所有输入输出均为JSON格式,单元格地址统一使用A1范围表示法,错误信息也以结构化JSON输出到stderr,方便AI代理解析和处理。

它非常适合需要让AI代理自动化处理Excel数据的开发者和团队,尤其是那些在CI/CD流程中、数据分析流水线中或智能体工作流中频繁操作表格的场景。数据分析师、智能体开发者、运维工程师都可以用它来减少手动编码的负担。

建议在AI代理的自动化工作流中统一集成此工具,用于批量生成报表、修改表格数据、提取关键信息等。需要注意的是,它主要面向数据读写操作,不支持复杂的格式(如合并单元格、图表、条件格式),适合结构化的表格数据场景。

常见问题

如何安装agent-xlsx?

执行curl -fsSL https://raw.githubusercontent.com/carderne/agent-xlsx/main/install.sh | bash -s -- ~/.local/bin,将二进制安装到指定目录(需在PATH中)。

支持读取哪些单元格范围?

支持A1范围表示法,例如A1:C3、Sheet1!A1:B2等,所有操作均通过JSON格式输出。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/agent-xlsx-chrisarderne/raw/index.md 读取 agent-xlsx 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。