Files
agent/skills/office/SKILL.md
T
kicer a52b227d8b refactor(skills): 本地安装改成「README 式说明」,install.sh/requirements.txt 归服务器
按三条原则收紧:
1) 线上零影响:office/install.sh 回退成原来的 linux-only 版本(本地本来就不该跑它);
   image-process 的字体候选表撤回(那是在代码里写环境兼容,方向错了)。
2) install.sh / requirements.txt 只做服务器工件:镜像构建与 agent-executor-init 读它们,
   行为一字未变。
3) 本机缺东西时由 .md 指路,模型自己去装:四个技能各加 INSTALL.md(具体命令 + 平台
   资产/字体表 + 验证方式),并在 SKILL.md 里各加一行指向它(skill get 就能看到)。
   报错文案带上 INSTALL.md 的绝对路径,所以「撞到缺依赖」的那一刻就能拿到说明书。

保留的两处代码钩子都不是环境探测,而是「说明书里写的安装方式得真能生效」:
- office: start.sh 把 skills/office/scripts 塞进 PATH(本地没 root 写 /usr/local/bin);
  封装层 ENOENT 指向 INSTALL.md。
- x2pdf: find_soffice() 探 macOS app bundle(brew cask 装的 soffice 不在 PATH);
  WeasyPrint 不可用时回落 LibreOffice,让本地只需一个后端而不是 pango+WeasyPrint 两条链。

INSTALL.md 里 officecli 指向 releases/latest(它会自更新,实测 1.0.157 跑一次变 1.0.160),
不要求与服务器 pin 对齐。

实测:office --version / office create / office view outline 正常;x2pdf 缺 markdown 与
image-process 缺字体两条报错都给出 INSTALL.md 绝对路径,按 font 参数即通过。
2026-11-11 17:34:30 +08:00

39 lines
1.7 KiB
Markdown

---
name: office
description: Office 文档(docx/xlsx/pptx)创建、精确编辑、结构检视
required: 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 读回选区再针对性改。
## 注意
- 所有操作文档在任务目录里。
- 缺 `bin/officecli`(报 `binary missing`)时:按同目录 `INSTALL.md` 自己装;服务器端由镜像构建 / `agent-executor-init` 提供,本机不要跑 `install.sh`。
- `view` 的渲染族(html/screenshot/pdf 等)本环境不可用;要 PDF 用 x2pdf 技能。