前言¶
让模型直接改 Word、Excel、PPT,常见的做法是让模型生成 python-docx / openpyxl 脚本再跑,依赖要装、文件要锁定、格式还常常跑偏。另一个路子是调用 Office COM 或 LibreOffice 转换,得先装一整套 Office。下面介绍的 Skill 走的是第三条路:它背后是一个单二进制的 CLI,一行命令安装,不依赖 Office,也不依赖 Python 包。
这个 Skill 叫 AI 智能体办公套件,坐标 @jishangtech/js-08,版本 1.0.1,发布者是技赏网络科技,分类 office-efficiency,来源 enterprise。它是对 GitHub 上 iOfficeAI/OfficeCLI 的搬运,上游是 Apache-2.0 协议的开源项目。Skill 本身是 SKILL.md 格式,核心内容就是教会模型怎么调 officecli 命令。
这是什么¶
一句话:把 officecli 这个 CLI 的操作方式包装成 Skill,让模型能创建、读取、分析、修改 .docx、.xlsx、.pptx,无需安装 Office,零依赖。
它解决的问题是办公文档的自动化入口。模型不需要理解 OOXML 的全部细节,只需要知道 officecli 的命令和路径规则;反过来,凡是模型用自然语言说不清楚格式的地方,officecli 的 help 系统会给出 schema。
核心功能¶
1、创建与写入。create 生成空白的 .docx / .xlsx / .pptx,类型由扩展名决定;add / set 在指定路径上新增或修改节点。
2、读取与检查。view 提供 outline、stats、issues、text、annotated、html 等多种模式;get 按 XML 路径取节点;query 用类 CSS 选择器筛选;validate 对照 OpenXML schema 校验文件。
3、修改策略是三层。L1 直接读写,L2 走 DOM 编辑,L3 兜底改原始 XML。Skill 明确要求优先用更高层,避免直接动 XML。
4、路径寻址支持稳定 ID。元素有稳定 ID 时返回 @attr=value 形式的路径,插入或删除元素后位置索引会变,稳定 ID 不会,长流程里应当优先用它。
5、常驻模式。首次访问会自动启动常驻进程,60 秒空闲超时,避免文件锁冲突;长任务可以显式 open / close。
6、帮助系统。不确定属性名、取值格式或命令语法时,一律先跑 officecli help,不要猜。help 支持按动词过滤,也可以 --json 输出结构化 schema。
安装与启用¶
先装 officecli,再加载 Skill。安装命令来自上游 OfficeCLI 的 SKILL.md,macOS / Linux 用一条 curl:
curl -fsSL https://d.officecli.ai/install.sh | bash
Windows 用 PowerShell:
irm https://d.officecli.ai/install.ps1 | iex
装完用 officecli --version 验证。如果命令找不到,新开一个终端再试。
Skill 侧的启用方式,官方页面 https://api.skillhub.cn/jishangtech/js-08 和 https://www.skillhub.cn/skills/jishangtech/js-08 在撰写本文时均无法访问,因此不给出未核实的 SkillHub 侧安装命令或配置字段。按通用 SKILL.md 流程,正常路径是把 SKILL.md 放进对应 Skill 目录后由模型按需加载;上游 SKILL.md 中还提到,涉及融资路演、学术论文、财务模型、数据看板、Morph 动画时,要先加载对应的专用 Skill,再继续操作文档。
典型用法¶
下面三段是上游 SKILL.md 给出的最小可复现流程。先建 PPT,再加幻灯片和文本框:
officecli create slides.pptx
officecli add slides.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add slides.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
Word 走段落和样式:
officecli create report.docx
officecli add report.docx /body --type paragraph --prop text="Executive Summary" --prop style=Heading1
officecli add report.docx /body --type paragraph --prop text="Revenue increased by 25% year-over-year."
Excel 走单元格:
officecli create data.xlsx
officecli set data.xlsx /Sheet1/A1 --prop value="Name" --prop bold=true
officecli set data.xlsx /Sheet1/A2 --prop value="Alice"
读取侧建议先跑 officecli help docx paragraph 确认属性名,再写 get / set 命令。格式别名也值得记住:word 对应 docx,excel 对应 xlsx,ppt / powerpoint 对应 pptx;动词有 add、set、get、query、remove 五种。
适用场景与注意¶
适合的场景:批量生成报告、模板填充、文档内容查找替换、格式问题检测与修复、财务模型与数据看板、学术论文排版、融资路演 PPT、Word 可填表单、Morph 动画 PPT。Skill 简介里给的触发词覆盖中英文,包括 Office 文档、办公三件套、演示文稿、spreadsheet、workbook、deck、slides、report、letter、financial model、dashboard、pitch deck、tracker,以及 docx、pptx、xlsx。
需要注意的几点:
1、SkillHub 侧的评分和下载数在资料里有两套数字,抓取到的官方页显示评分 100000、下载 10649、安装 0;另有一处写评分 95350、下载 10275。两处都未在官方页面复核到,建议以官网当前展示为准。
2、Skill 在 SkillHub 上标记为 pricing_type=paid、requires_api_key=false,即付费但不需要 API Key。付费内容的具体条款官方页面未能访问,使用前需自行确认。
3、view html 和 watch 依赖无头浏览器;screenshot、pdf、forms 等模式依赖 exporter 或 format-handler 插件,不是开箱即用的全部能力。
4、flush 时机有约定:officecli 自己的读取总能看到最新编辑,只有在把文件交给非 officecli 程序(python-docx、openpyxl、Word、渲染器、上传)之前才需要 save 或 close。
5、上游仓库的协议是 Apache-2.0,SkillHub 上这个搬运版本来自 enterprise 来源,商用前建议确认搬运方的分发条款。
结尾¶
这套 Skill 的价值在于把办公文档操作收敛到一个无依赖的 CLI 上,模型侧只需要记住命令和路径规则,格式问题交给 help 和 validate。适合想把 Word / Excel / PPT 生成纳入自动化流程的团队。官方地址:https://api.skillhub.cn/jishangtech/js-08,上游项目:https://github.com/iOfficeAI/OfficeCLI。