DOCX文档处理技能：专业格式编辑、视觉布局审阅与自动化渲染指南 | SkillsMDDOCX文档处理技能：专业格式编辑、视觉布局审阅与自动化渲染指南
doc by aleister1102/skills
npx skills add https://github.com/aleister1102/skills --skill doc🇨🇳中文介绍
DOCX 技能
使用时机
- 阅读或审阅注重布局的 DOCX 内容（表格、图表、分页）。
- 创建或编辑具有专业格式的 DOCX 文件。
- 在交付前验证视觉布局。
工作流程
- 优先进行视觉审阅（布局、表格、图表）。
- 如果
soffice 和 pdftoppm 可用，则转换 DOCX -> PDF -> PNG。
- 或者使用
scripts/render_docx.py（需要 pdf2image 和 Poppler）。
- 如果缺少这些工具，请安装它们或要求用户在本地审阅渲染后的页面。
- 使用
python-docx 进行编辑和结构化创建（标题、样式、表格、列表）。
- 每次有意义的更改后，重新渲染并检查页面。
- 如果无法进行视觉审阅，则使用
python-docx 提取文本作为后备方案，并指出布局风险。
- 保持中间输出文件组织有序，并在最终批准后进行清理。
临时文件和输出约定
- 使用
tmp/docs/ 存放中间文件；完成后删除。
🇺🇸English
DOCX Skill
When to use
- Read or review DOCX content where layout matters (tables, diagrams, pagination).
- Create or edit DOCX files with professional formatting.
- Validate visual layout before delivery.
Workflow
- Prefer visual review (layout, tables, diagrams).
- If
soffice and pdftoppm are available, convert DOCX -> PDF -> PNGs.
- Or use
scripts/render_docx.py (requires pdf2image and Poppler).
- If these tools are missing, install them or ask the user to review rendered pages locally.
- Use
python-docx for edits and structured creation (headings, styles, tables, lists).
- After each meaningful change, re-render and inspect the pages.
- If visual review is not possible, extract text with
python-docx as a fallback and call out layout risk.
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
output/doc/ 目录下。保持文件名稳定且具有描述性。依赖项（如果缺失则安装）
uv pip install python-docx pdf2image
python3 -m pip install python-docx pdf2image
# macOS (Homebrew)
brew install libreoffice poppler
# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils
如果无法在此环境中安装，请告知用户缺少哪个依赖项以及如何在本地安装。
环境
渲染命令
soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX
pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages
质量要求
- 交付一份可供客户使用的文档：一致的排版、间距、边距和清晰的层级结构。
- 避免格式缺陷：文本被裁剪/重叠、表格损坏、字符不可读或使用默认模板样式。
- 图表、表格和视觉元素在渲染页面中必须清晰可辨，对齐正确。
- 仅使用 ASCII 连字符。避免使用 U+2011（不间断连字符）和其他 Unicode 破折号。
- 引用和参考文献必须是人类可读的；切勿留下工具令牌或占位符字符串。
最终检查
- 在最终交付前，以 100% 缩放比例重新渲染并检查每一页。
- 修复任何间距、对齐或分页问题，并重复渲染循环。
- 确认没有遗留文件（临时文件、重复渲染），除非用户要求保留。
Temp and output conventions
- Use
tmp/docs/ for intermediate files; delete when done.
- Write final artifacts under
output/doc/ when working in this repo.
- Keep filenames stable and descriptive.
Dependencies (install if missing)
Prefer uv for dependency management.
uv pip install python-docx pdf2image
python3 -m pip install python-docx pdf2image
System tools (for rendering):
# macOS (Homebrew)
brew install libreoffice poppler
# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils
If installation isn't possible in this environment, tell the user which dependency is missing and how to install it locally.
Environment
No required environment variables.
Rendering commands
soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX
pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages
Quality expectations
- Deliver a client-ready document: consistent typography, spacing, margins, and clear hierarchy.
- Avoid formatting defects: clipped/overlapping text, broken tables, unreadable characters, or default-template styling.
- Charts, tables, and visuals must be legible in rendered pages with correct alignment.
- Use ASCII hyphens only. Avoid U+2011 (non-breaking hyphen) and other Unicode dashes.
- Citations and references must be human-readable; never leave tool tokens or placeholder strings.
Final checks
- Re-render and inspect every page at 100% zoom before final delivery.
- Fix any spacing, alignment, or pagination issues and repeat the render loop.
- Confirm there are no leftovers (temp files, duplicate renders) unless the user asks to keep them.
Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程
29,800 周安装
