Communitygithub.com

michellema8890/pdf-to-editable-word-skill

将PDF文件转换为可编辑的Word文档,同时保留原始布局,适用于AI Agent工作流。

pdf-to-editable-word-skill 是什么?

该技能提供了一种可靠、确定性的方法,可将PDF文件转换为可编辑的Word文档(DOCX格式),同时尽可能保留原始布局。它通过结合清理后的页面背景与绝对定位的可编辑文本框来实现忠实于原版的视觉呈现。该技能支持检测输入PDF是否满足转换条件,若条件不满足(例如存在不兼容的特性),会主动停止并报告问题,从而避免生成低质量结果。支持断点续传功能,以及输出验证以确保转换质量。该技能可作为命令行工具(基于Python)使用,适用于任何支持执行外部CLI命令的AI编码Agent(如Claude Code、Cursor等)。目前不支持OCR、混合页面大小或LibreOffice格式保真度,且不保证表格、图表或图像具有语义可编辑性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add michellema8890/pdf-to-editable-word-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

PDF 转可编辑 Word 技能

创建一个视觉上忠实于原版的 DOCX,将清洗后的页面背景与可编辑的、绝对定位的文本框相结合。对所有转换任务都运行确定性的 CLI;不要手动重新创建 OOXML。

工作流程

  1. 解析此技能目录,并使用 scripts/pdf2word.py 作为命令包装器。
  2. 在转换前检查源文件:
python scripts/pdf2word.py inspect INPUT.pdf --json
  1. 当 conversion_ready 为 false 时,停止并报告限制。阅读 compatibility.md 以了解相关的失败模式。
  2. 转换到专用工作目录:
python scripts/pdf2word.py convert INPUT.pdf OUTPUT.docx --work-dir WORK_DIR --dpi 144
  1. 如果转换中断,使用 --resume 重新运行相同的命令。切勿为不同的 PDF 或页面范围重用工作目录。
  2. 对照源文件验证输出:
python scripts/pdf2word.py validate OUTPUT.docx --pdf INPUT.pdf --json
  1. 将验证失败视为转换失败。不要仅仅因为文件存在就交付 DOCX。
  2. 对于高风险的输出,请在 Microsoft Word 中打开结果,检查第一页、中间页和最后一页,以及布局特殊的页面。

交付

报告输出路径、页数、可编辑文本框数量、背景图片数量、验证结果以及任何兼容性警告。明确指出文本是可编辑的,而非文本图形保留在页面背景中。

不要声称表格、图表或图像具有语义可编辑性。不要声称在 v0.1 中支持 OCR、混合页面大小或 LibreOffice 保真度。

相关技能