OfficeCLI Skill:让 AI Agent 一行命令搞定 Word/Excel/PPT
总结
OfficeCLI 把 AI 时代的 Office 三件套(Word/Excel/PPT)做成了一个对 Agent 友好的「单二进制命令行工具」——无需安装微软 Office,AI Agent 用一行命令就能读、改、生成 docx/xlsx/pptx。它连续数周霸榜 GitHub Trending 月榜,截至 2026-08-04 已斩获约 25,180 颗 star,最近一个月狂涨 16,458 star,是当下 Skill 圈最炙手可热的「让 Agent 真正能干活」的基础设施型技能。
功能与原则
核心能力:用一个统一的 officecli 命令同时操作 Word/Excel/PPT 三类文件,既支持 view <file> html(浏览器实时渲染预览)也支持 add / get / set / remove 等结构化编辑子命令,还能把文件解析为 JSON 给 Agent 读。
设计原则有三:(1)零依赖——单二进制,Linux/macOS/Windows 全部开箱即用,不需要本机装 Office;(2)双向通道——既能渲染(给 AI 「眼睛」看排版),又能结构化修改(给 AI 「手」去改字段);(3)Skill 优先——官方维护一份 SKILL.md,任何 Agent curl 一下就能自学安装,把工具自动挂到 Claude Code、Cursor、Windsurf、GitHub Copilot 等任意 IDE。
认可度
- GitHub Star 数(截至 2026-08-04):约 25,180 颗(GitHub Trending 月榜常客,最近 30 天新增 16,458 star,势头极猛)
- 月榜位置:GitHub Trending monthly 长期 Top 10 内
- 配套桌面 GUI 项目
AionUi同步走红,可「用自然语言生成 Office 文档」 - 提供官方 SKILL.md 安装钩子,被 Claude Code、Cursor、Windsurf、Copilot 等主流 Agent 生态原厂兼容
链接
GitHub: https://github.com/iOfficeAI/OfficeCLI
原作者
iOfficeAI 团队维护,核心仓库作者 goworm / IceyLiu / ringringlin 等。团队定位明确——「做 AI 时代的 Office 套件」,配套 AionUi 桌面应用(自然语言版)和 officecli.ai 官网。社区活跃在 Discord(2QAwJn7Egx)。
介绍
OfficeCLI 号称「世界上第一款专为 AI Agent 设计的 Office 套件」,把原本需要 python-pptx、openpyxl、python-docx 三套库配合 50+ 行样板代码才能完成的事,压成一条命令。
Agent 在拿到一份 docx/xlsx/pptx 后,既可以用 officecli view <file> html 在浏览器里看到真实渲染效果(这是「让 AI 有眼睛」的关键一步),也可以用 officecli add/get/set/remove 按结构化路径(如 /slide[1]/shape[1])精准修改任意元素,所有改动都会被实时回写到文件并触发 watch 预览刷新。
Word 侧支持完整的 i18n/RTL、图表(支持 mermaid 转原生可编辑形状)、公式(LaTeX 输入)、修订追踪、SDT 内容控件、22 种字段类型;Excel 侧支持 350+ 公式、透视表、切片器、动态数组、条件格式;PPT 侧支持纯命令行 create/add/set/play,完全不需要模板。
特点
- 单二进制,真零依赖——
curl | bash一行装完,不要求本机有 Microsoft Office 或 LibreOffice,适合塞进 Agent 沙箱/CI - 结构化路径操作——
/slide[1]/shape[2]这种 XPath 风格定位,让 LLM 直接读懂「改第二张幻灯片的第二个文本框」而不用解析原始 XML - 自带 HTML 渲染引擎——
view html命令把 .docx/.xlsx/.pptx 高保真渲染到浏览器,Agent 能用截图回环验证排版 - 官方 SKILL.md 安装钩子——任何 Agent
curl https://officecli.ai/SKILL.md就能被引导自安装,Claude Code / Cursor / Windsurf / Copilot 全兼容 - 配套 AionUi 桌面 GUI——给不想用命令行的同学一个「自然语言生成 Office 文档」的图形入口
使用方法
1. 让 Agent 自学安装(推荐)
直接在 Claude Code / Cursor 里粘贴:
curl -fsSL https://officecli.ai/SKILL.md
Agent 会读取这份 SKILL.md,自动完成二进制下载和 skill 挂载。
2. 手动安装
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# 或 brew
brew install officecli
# 或 npm
npm install -g @officecli/officecli
3. 最小示例:Agent 创建并预览一份 PPT
officecli create deck.pptx
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
officecli watch deck.pptx # 浏览器自动打开 http://localhost:26315 实时预览
使用场景与人群
- Agent / Vibe Coding 用户:让 Claude Code / Codex / Cursor 直接产出真正的 .docx/.xlsx/.pptx 交付物,而不是只能生成 Markdown
- 自动化办公场景:批量生成周报、合同模板、财务模型、PPT 套版,无需打开 Office 客户端
- CI/CD 流水线:在 CI 里跑
officecli add / set,把生成好的文档直接当 build artifact 发布 - 数据/咨询从业者:用
view html+ LLM 解读 Excel 数据透视、Word 修订批注 - 不适合:需要 Photoshop 级图文混排、复杂动画、品牌 VI 像素级还原的设计场景——OfficeCLI 主打「结构化文本/数据/演示」,不是 InDesign 替代品
输入与输出案例
案例 1:输入一个 PDF 报告 + 一句自然语言 → 输出可直接打开的 PPT
输入(给 Agent):
「读这份 PDF 季度报告,用 OfficeCLI 生成一份 8 页的 Q4 Review PPT,首页标题用『Q4 2026 Business Review』,深色背景,中间放核心数据图表,最后一页放联系方式。」
Agent 调用流程:
1. officecli create deck.pptx
2. 逐页 officecli add 创建幻灯片、文本框、表格
3. officecli view deck.pptx html 渲染检查
4. officecli close 保存
输出:deck.pptx —— 一份 8 页、可直接 PowerPoint 打开、还能继续手动微调的演示文稿。
案例 2:输入一个 xlsx → 输出结构化 JSON 给 LLM 做分析
输入文件 sales_2026.xlsx(几万行销售明细)
officecli get sales_2026.xlsx '/sheet[1]/row[Region=EMEA and Revenue>5000]' --json
输出(JSON 片段):
[
{"row": 42, "Region": "EMEA", "Revenue": 12800, "Product": "Acme Pro"},
{"row": 87, "Region": "EMEA", "Revenue": 9200, "Product": "Acme Lite"}
]
Agent 拿到这份 JSON 后可以直接做汇总、写结论、生成图表,整个过程不再需要 pandas.read_excel 那一堆样板。
评论区
登录后可评论。