agent-xlsx
为AI Agent提供深度解析Excel文件的命令行工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-xlsx。 它的用途是：为AI Agent提供深度解析Excel文件的命令行工具 完整的 Skill 内容见：https://321skill.com/skills/agent-xlsx/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
对AI Agent说：‘请分析一下这份销售报表。’，它会先使用`agent-xlsx probe`命令获取工作簿的整体结构，然后根据你的进一步指令，用`read`读取特定区域数据，或用`screenshot`获取图表可视化效果，最终生成一份结构化的分析摘要。
介绍
agent-xlsx 是一个专为AI Agent设计的命令行工具，旨在解决LLM智能体在处理Excel文件时的核心痛点。现有Excel库多为人类开发者编写脚本而设计，导致智能体需要多次低效交互才能理解工作簿全貌，浪费大量Token。
该工具通过probe、read、search、screenshot等简洁命令，让AI Agent能像人类在Excel中操作一样，分层渐进地探索工作簿的结构、数据、格式、图表、公式乃至VBA代码，所有信息均以Token高效的JSON格式返回。
它非常适合集成在Claude Code、Cursor、Gemini CLI等20多种AI Agent环境中，作为其处理Excel数据的专用技能。开发者和AI应用构建者可以轻松将其添加至智能体技能库，赋能智能体进行复杂的数据分析与报告生成。
与openpyxl、pandas等通用库不同，agent-xlsx从设计之初就遵循三大原则：渐进式披露（按需获取细节）、速度优先（基于Polars和Rust后端，读取速度提升7-10倍）、以及Token效率优先（输出经过优化，智能体通常只需1-2轮交互即可全面理解工作簿）。
核心特点
核心区别在于其专为AI Agent工作流设计，提供渐进式、Token高效的交互接口，而非面向人类开发者的通用编程API。它通过`probe`先获取结构骨架，再按需深入`read`或`screenshot`的流程，极大减少了AI理解复杂Excel文件所需的交互轮次和Token消耗。
注意事项
其`screenshot`等功能依赖需商业授权的Aspose.Cells库，免费使用会有水印和文件数量限制；对于仅需简单数据读取的场景，可能显得过于重型。
常见问题
agent-xlsx和直接用pandas读取Excel有什么区别？
pandas是为脚本编程设计的，一次读取全部数据；agent-xlsx是为AI Agent交互设计的，支持分层、渐进式探索，且输出为Token优化的JSON，更适合LLM处理。
使用screenshot功能需要付费吗？
是的，screenshot依赖Aspose.Cells库，需购买商业许可才能去除水印并解除文件数量限制，否则处于评估模式。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-xlsx/raw/index.md 读取 agent-xlsx 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-xlsx/raw/index.md（查看排版版本）