OfficeCLI Skill 技能

技能简介

OfficeCLI 是全球首个专为 AI Agent 设计的 Office 套件工具，能够让 AI 代理自主完成 Word 文档、Excel 电子表格和 PowerPoint 演示文稿的读取、编辑和创建操作。该项目完全开源、免费，单个二进制文件即可运行，无需安装 Microsoft Office，也无任何外部依赖，支持 macOS、Linux 和 Windows 全平台。

核心能力

单行命令驱动 Office 全套操作 在 AI 编码代理（如 Claude Code、Cursor、Windsurf、GitHub Copilot）的对话窗口中粘贴一条命令，Agent 即可自动安装 OfficeCLI 并获得完整的 Word / Excel / PowerPoint 操作能力，无需手动配置环境或编写额外代码。

零依赖的独立二进制分发 OfficeCLI 以单一可执行文件发布，下载即用。安装后会检测当前环境中的 AI 编码代理，自动将 SKILL.md 安装到对应工具中，使 Agent 在下一轮对话时即可使用 officecli 系列命令。

高精度 HTML 渲染引擎 内置 HTML 渲染引擎，将 .docx / .xlsx / .pptx 文件渲染为高保真 HTML 或 PNG 图片，让 AI 能够「看见」文档内容，配合视觉理解能力完成精准的内容分析和修改。

实时预览与热更新 officecli watch 命令可启动本地预览服务器（默认端口 26315），在浏览器中实时预览文档状态。每执行一次 add / set / remove 命令，预览页面即时刷新，形成所见即所得的编辑闭环。

结构化数据读取与修改 支持以纯文本或 JSON 格式读取文档中的文字、结构、样式和公式；可对文档内任意元素（文字、字体、颜色、布局、公式、图表、图片）进行精确修改，并支持跨文档的内容迁移和批量操作。

安装配置

方式一：AI Agent 自动安装（推荐） 在支持 Agent 的对话中粘贴以下命令，Agent 会自动读取 SKILL.md 并完成安装：

curl -fsSL https://officecli.ai/SKILL.md

方式二：独立安装（macOS / Linux）

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

方式三：Homebrew

brew install officecli

方式四：npm 全局安装

npm install -g @officecli/officecli

方式五：Windows PowerShell

irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

使用步骤

第一步：创建空白演示文稿

officecli create deck.pptx

第二步：启动实时预览

officecli watch deck.pptx

浏览器打开 http://localhost:26315 查看文档预览。

第三步：添加幻灯片与内容

officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E officecli add deck.pptx /slide[1] --type shape --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm --prop font=Arial --prop size=24 --prop color=FFFFFF

每执行一次，预览页面实时刷新。

第四步：查看大纲与结构

officecli view deck.pptx outline

以大纲形式展示文档结构，便于确认内容层级。

第五步：保存并导出

officecli close deck.pptx

关闭文档时自动将内存中的修改刷写到磁盘，生成最终的 .pptx / .docx / .xlsx 文件。

适用场景

AI 代理自动化办公 在 Claude Code / Cursor 等 AI 编码代理的对话中，直接用自然语言要求 Agent「创建一个 Q4 汇报 PPT」「将这份 Excel 报告的数据可视化」，Agent 调用 OfficeCLI 自动完成，无需人工介入。

批量文档生成 为多个客户或多个项目批量生成格式统一的 Word 报告、Excel 数据表或 PPT 演示文稿，通过脚本调用 officecli 命令实现全流程自动化。

文档格式转换与修复 将旧版 .doc 文件批量迁移为标准 .docx，或将设计稿导出为 PPT。对接 i18n / RTL 多语言文档需求，支持阿拉伯语、希伯来语等从右到左排版。

企业级文档内容审核 自动分析 Word 文档的格式不一致问题、样式混乱、章节结构缺陷，生成修复建议并批量执行，保持文档规范性。

适用人群

AI 开发者、自动化工程师、需要 AI 代理代为处理 Office 文档的产品经理和运营人员，以及需要批量生成标准化商业文档的企业用户。

工作原理

OfficeCLI 内置了对 Office Open XML（.docx/.xlsx/.pptx）格式的完整解析与序列化能力，无需 Microsoft Office 即可读写文件。其 HTML 渲染引擎将文档内容渲染为浏览器可显示的格式，使 AI 代理能够通过视觉方式「看见」文档外观，再结合命令行的结构化输出（JSON / 纯文本）完成精确的内容修改。安装后通过修改 AI 代理的 SKILL.md 文件，将 officecli 命令注册到 Agent 的工具集中，使 Agent 在对话中能够自然地调用相关命令。

官方链接

官网：https://officecli.ai GitHub：https://github.com/iOfficeAI/OfficeCLI