OfficeCLI 办公文档工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_0d470017/20260818。
技能介绍
为什么要用 CLI 而不是手工改 Office
在 Agent 或脚本里处理 .docx、.xlsx、.pptx 时,常见路径是调 python-docx/openpyxl 或让人类打开 Word——前者要手写 OOXML 细节,后者无法自动化。officecli 把同一套操作暴露成可 grep、可 JSON 化的命令行:检视结构、查格式问题、按路径改属性、批量 find/replace,且不需要本机安装 Office。
技能如何引导使用方式
本技能的核心是教模型按 L1(读/检视)→ L2(DOM 级 set/add/find)→ L3(原始 XML) 分层处理问题,并规定:拿不准属性名或取值格式时先跑 officecli help,不要猜。
典型工作流包括:
- 检视:
view的outline/stats/issues/html等模式;get/query用元素路径或类 CSS 选择器(含稳定@id=寻址,避免插入删除后下标漂移)。 - 交互定位:
watch在浏览器里点选形状或段落,get selected读当前选区,适合 PPT/Word 里「先指哪改哪」。 - 修改:
set改任意 XML 属性或--prop font.*等简写;find/replace可跨 run 边界;add按类型追加 slide、shape、table、chart 等(格式各有别名,以 help 为准)。 - 常驻进程:首次访问会自动起 resident,同文件工作流内读操作总能看到最新编辑;只在交给 非 officecli 程序(如 Word、
python-docx、上传交付)前再save/close。
做融资 deck、学术论文、财务模型等前,技能会要求先加载文档里列出的 Specialized Skills,再执行通用 officecli 命令。
边界与注意点
- Watch 选区:
.xlsx当前不提供可靠 data-path,选区常标记为 stale;v1 对组形状整体选中,不能钻进组内子形状。 - Excel 上
set以 find+replace 等有限能力为主,复杂版式仍要对照 help。 - Morph 动画、部分 diagram 等场景依赖子技能或 add-only 路径,不能指望单靠通用 set 完成全部版式。
- 多步流水线里应优先 稳定 ID 路径,并在边界处显式 flush,避免外部工具读到旧文件。
使用场景
- CI 里对投标用 PPT 跑 `view issues --type format`,在合稿前把版式与结构问题列成清单
- 周报 Word 里用 `find` 跨 run 替换术语,并用 `revision` 相关路径批量接受或拒绝_track 修改
- 财务同事给的 xlsx 用 `query` 按列名筛选行(如 `Sheet1!row[Salary>5000]`),再只改匹配单元格
- 开着 `watch` 在浏览器点标题形状,用 `get selected` 取路径后对同一页 `set` 字体与颜色
适合人员
- 用 Agent 批量生成或改版投标 PPT、需要 outline/issues/html 检视而不是肉眼翻页的方案顾问
- 维护合同与政策 Word 模板、要在脚本里按段落路径改样式并处理修订记录的法务运营
- 把多表 Excel 当数据源做例行抽取与局部替换、又不愿在本机装 Office 的数据分析同事
- 做文档流水线(渲染、上传、diff)需要在交给 python-docx 或 Word 前用 officecli 显式 flush 的集成工程师