Files
agent/skills/office/SKILL.md
T
kicer 77ef1ec11c feat(skills): office 本地放行 watch、x2pdf 加浏览器后端
office 封装层:本地直跑(AGENT_LOCAL_PICK)没有预览网关,不发 ui_card、
不 POST __pv-touch;watch/unwatch 与 mark/goto 族放行,watch 改后台拉起 +
等端口就绪后报地址退出(前台透传会卡到 terminal 超时)。

x2pdf:文本类分派改为 WeasyPrint → 无头浏览器 → LibreOffice,浏览器后端只需
装了 Chrome 系,不要求用户为转 PDF 现编 pango;CSS/base 注入到 head,无 @page 时
补 A4(浏览器默认 Letter)。吞掉 WeasyPrint 导入失败时裸 print 到 stdout 的告警。
对外文案只讲结果(排版降级/无可用排版能力),实现细节留在 AGENTS.md。
2026-11-11 20:50:18 +08:00

1.7 KiB

name, description, required
name description required
office Office 文档(docx/xlsx/pptx)创建、精确编辑、结构检视 true

功能

Word / Excel / PPT(.docx/.xlsx/.pptx)的创建、读取、精确修改与结构检视。

调用方式

所有操作通过 terminal 工具执行同一个入口脚本(cwd 已是任务目录,直接用相对文件名;不要自行调用底层文件执行操作):

office <command> [args...]

先用 office help 看命令清单,用 office help <主题>(如 office help docx paragraph)查具体元素的属性 schema——参数与属性以 help 为准,不要凭记忆猜。

常用动线:

  • office create <file> 新建文档
  • office open <file> 打开已有文档
  • office set / get / query <file> ... 按 schema 精确改动与读取;每次改动自动落盘
  • office view <file> outline|stats|issues|text 结构/语义自检
  • office save / close <file> 收尾(改动已自动落盘,save 只是显式冲刷)
  • office get-pos <file> 回读用户在预览里选中的文件内容(返回 JSON,path 里的 @id 可稳定用于后续 set/get 定位)

预览协作

create/open 成功后,用户可自行查看该文档的实时预览(预览页上的选区、标注类交互之后都能被 get-pos 读到)。用户反馈"看第几段/选中了哪里/修改哪里"时,优先用 get-pos 读回选区再针对性改。

本地直跑没有预览卡片时,用 office watch <file> 起自带预览页(立即返回本机地址), office unwatch <file> 停。

注意

  • 所有操作文档在任务目录里。
  • view 的渲染族(html/screenshot/pdf 等)本环境不可用;要 PDF 用 x2pdf 技能。