Files
agent/skills/office/SKILL.md
T
kicer 5f4b3ec28b officecli 迁入技能层:skills/office 封装 + executor 预览托管,双盘同步整条退役
- skills/office:SKILL.md + scripts/office 封装层(命令闸门/help 对齐/get-pos 语义糖/create、open 出 ui_card
  marker);install.sh 按技能双跑约定把二进制拉到技能卷 bin/(不进 git/不进镜像,GitHub→gh-proxy 备源)
- executor/preview.js:预览槽位+网关(原 mcp 侧 watch/gateway 移植),工作区=tasks 卷真实文件,
  /__session-kill 供 core 清槽;Dockerfile 零 officecli 痕迹,入口符号链接进 /usr/local/bin/office
- core:preview-proxy 默认上游改 agent-executor:3100;tools/executor.js 通用 drainUiCards(terminal 输出
  ::ui_card 标记行 → 剥离 + ctx.onCard,任意命令可产卡);engine 删会话改走 rexec.killPreviewSession
- compose:agent-executor expose 3100(只走内网);.gitignore 排除技能二进制
2026-10-19 11:30:12 +08:00

1.9 KiB

name, description
name description
office Office 文档(docx/xlsx/pptx)创建、精确编辑、结构检视与聊天实时预览

功能

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 结构/语义自检(交付前建议跑一遍 issues)
  • office save / close <file> 收尾(改动已自动落盘,save 只是显式冲刷)
  • office get-pos <file> 回读用户在预览里选中的内容(返回 JSON,path 里的 @id 可稳定用于后续 set/get 定位)

预览协作

create/open 成功后无需拼链接、无需等待:聊天流自动出可点击的预览卡片,用户点开即是该文档的实时预览(预览页上的选区、标注类交互之后都能被 get-pos 读到)。用户反馈"看第几段/选中了哪里"时,用 get-pos 读回再针对性改。

注意

  • 文档就在任务目录里:文件面板、预览、下载指向同一份文件;不要用 curl 或中转链搬运待编辑的文档。
  • view 的渲染族(html/screenshot/pdf 等)本环境不可用;要 PDF 用 x2pdf 技能。
  • 命令报"文件不存在"时先确认文件是否已在任务目录(ls),不要猜路径。