SuperAPI AI 工具集

doc

办公与效率

查看项目

更新于 10-16 03:47

技能介绍

用途:当任务涉及读取、审阅、创建或编辑 .docx 文档,且表格、图表、分页等版式保真度重要时使用。

主要能力:用 python-docx 进行结构化编辑与创建(标题、样式、表格、列表);通过 soffice 将 DOCX 转 PDF、再用 pdftoppm 转 PNG 做可视化审阅;也提供脚本 scripts/render_docx.py(需 pdf2image 与 Poppler)。

使用方式:编辑后每次有实质改动都重新渲染并检查页面。渲染命令示例:soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX,以及 pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME。依赖安装:uv pip install python-docx pdf2image;若 uv 不可用则 python3 -m pip install python-docx pdf2image。系统工具:macOS 用 brew install libreoffice poppler,Ubuntu/Debian 用 sudo apt-get install -y libreoffice poppler-utils。

中间文件放 tmp/docs/ 并在完成后删除,最终产物写至 output/doc/。无法可视审阅时,可退回到用 python-docx 提取文本并说明版式风险。该技能设计为跨 GitHub Copilot、Claude Code 与 Codex 使用;Codex 需同步到 $CODEX_HOME/skills/doc 并在大改后重启。无必需环境变量,无必需 MCP 服务器。

限制:缺少依赖时需安装或请用户在本地审阅;不可声称使用了当前宿主未提供的 MCP 操作;不得在缺少直接证据时宣称成功。输出要求使用 ASCII 连字符,避免 U+2011 等 Unicode 破折号,交付前需 100% 缩放逐页检查。