Files
agent/skills/office/SKILL.md
T
kicer 4e1c1f36d0 refactor(skills): 本机环境说明改放技能目录的 AGENTS.md,启动器不再特判任何技能
上一版把安装说明写成 INSTALL.md 并在 SKILL.md 里加段落,两处都不对:SKILL.md 是用法说明,
不该塞安装内容;启动器为 office 单独注入 PATH 也不成立,再加技能就得逐条改 start.sh。

- 删除 4 个 INSTALL.md,改为各技能目录下的 AGENTS.md(只写命令:下载/安装/验证、
  平台资产名、字体路径),SKILL.md 恢复原样
- start.sh 去掉 office 的 PATH 注入;技能要命令入口时由 AGENTS.md 指导按次前缀
  (PATH="$SK/scripts:$PATH" office ...)。启动器只保留 AGENT_SKILLS_DEPS 这个路径变量
- 找不到依赖时的指路不放在 core 里做特征匹配,而是各自报错带自己 AGENTS.md 的绝对路径
  (office 封装层 ENOENT / x2pdf 缺包或无后端 / image-process 缺字体)
- env-local 提示词加一句:技能失败就读其目录下的 AGENTS.md

实测:无 PATH 时 office 报 command not found,按 AGENTS.md 加前缀后 --version 正常;
三条缺依赖报错均给出 AGENTS.md 绝对路径。
2026-11-11 19:12:01 +08:00

1.5 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 读回选区再针对性改。

注意

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