SuperAPI AI 工具集

soia-dev-officecli-ops

办公与效率

查看项目

更新于 10-16 09:30

技能介绍

用途:将 OfficeCLI 封装为可复用的 Office 文件原子操作层,负责环境检查、结构读取、稳定定位、复制后修改、OpenXML 校验和预览证据,不替上层技能决定内容、叙事、品牌或视觉方向。

主要能力:可检查 Word/Excel/PPT 并提取结构、文本、统计与 issues,必要时渲染 HTML/截图;可用稳定 ID/名称定位,在副本上执行 set/add/remove/move/swap;三项及以上修改可组织为原子 batch;可创建基础 DOCX/XLSX/PPTX;并为其他技能提供 Office 底座与降级说明。

使用方式:提供 .docx/.xlsx/.pptx 路径并说明检查、创建或修改;修改已有文件需输出到不同路径,默认副本、不原地覆盖。安装本技能:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-officecli-ops -y。环境检查:python3 scripts/check_env.py。常用只读命令:python3 scripts/officecli_inspect.py --input <file> -- view outline / view stats --json / view issues --json / query '<selector>' --json / validate --json。安全包装器示例:python3 scripts/officecli_safe.py --input <source.pptx> --output <result.pptx> --dry-run -- set '/slide[1]/shape[@id=42]' --prop text='New title';确认后去掉 --dry-run。新建:python3 scripts/officecli_safe.py --output <result.docx> -- create。

限制:核心 workflow 需官方 officecli 可执行文件,最低推荐 1.0.137,低于该版本停止写操作;缺依赖时只报告官方安装选项,不自动执行远程安装脚本。删除、覆盖、raw XML、安装、MCP 注册须单独确认;路径须来自读取结果。validate 仅证明 OpenXML schema,视觉与版式需另行人工检查。install、mcp、插件安装等会修改用户环境,须客户明确确认后执行。