| name | agent-office |
| description | 当需要代办 Word、Excel、PPT、PDF 的新建、修改、重写、转换、批处理、导出与交付时,必须立刻阅读我。 |
Agent Office
任务定位
- 目标是替用户完成 Office 工作。
- 先区分任务属于哪一类:新建、修改、重写、批处理、转换、导出、校对。
- 能直接交付成品时,不要只停留在摘要或提取结果。
项目来源(必须先看)
- 主项目(Gitee):
https://gitee.com/CoderWanFeng/python-office/
- 主项目(GitHub):
https://github.com/CoderWanFeng/python-office
- 项目文档索引(RepoWiki):
https://github.com/CoderWanFeng/python-office/tree/develop/.qoder/repowiki/zh/content
事实边界
- 先看项目文档,再决定调用方式,不要臆测 API。
- 若仓库文档与本 Skill 冲突,以仓库文档为准,并向用户说明差异。
- 目前有明确证据的能力,主要集中在:转换、合并、拆分、查询、水印、加解密、导出。
- 目前没有充分证据表明
python-office 的公开 API 已提供通用的 Word/PPT 段落级创建与编辑能力。
- 因此,涉及精细新建或修改
docx/xlsx/pptx 时,优先直接使用底层库,而不是强行套 python-office。
工具选型
1. 只读场景
- 文档问答、摘要、检索前处理:优先
read_file
- PDF 文本分段提取:可配合
pymupdf(fitz)
2. 一行式批处理 / 转换 / 导出
- 优先
python-office
- 适合:批量合并、批量拆分、格式转换、导出 PDF、PDF 水印、PDF 加解密
3. 精细创建 / 修改 Office 文件
- Word:
python-docx
- Excel:
openpyxl
- PPT:
python-pptx
- 这类任务包括:新建文档、改标题层级、改段落、改表格、改单元格、改幻灯片结构
工作原则
- 先确认用户要的成品类型,再动手。
- 优先保留原始结构、原始语义和可编辑性。
- 不虚构原文没有的信息。
- 用户没要求时,不擅自重写全部内容或重排结构。
- 修改现有文件时,优先输出新文件,避免覆盖原件。
- 汇报时必须说明:生成了什么、改了什么、产物在哪里、还有什么限制。
推荐工作流
- 判断目标文件类型和交付物。
- 判断是“读取”还是“真正办事”。
- 选择最轻的可行工具链。
- 先做最小样本验证,再处理正式文件。
- 生成新文件并回报关键变更点。
常见任务分流
新建
- 从空白生成周报、方案、纪要、清单、统计表、汇报 PPT
- 优先用
python-docx / openpyxl / python-pptx
修改
- 改 Word 标题、段落、列表、表格
- 改 Excel 表头、单元格、sheet、汇总区
- 改 PPT 标题、正文、页序、提纲
- 优先用底层编辑库直接改结构
批处理
- 合并多个同类文件
- 按列拆分 Excel
- 批量导出 PDF / 图片
- 优先用
python-office
转换 / 导出
- Word 转 PDF
- Excel 转 PDF
- PPT 转 PDF / 图片
- PDF 转 docx / 图片
- 优先用
python-office
已确认的 python-office 高频能力
以下能力有明确仓库资料支持,适合优先考虑。
Excel
fake2excel:生成示例数据 Excel
merge2excel:多个 Excel 合并为一个工作簿
sheet2excel:将一个工作簿的多个 sheet 拆成多个文件
merge2sheet:将多份数据合并到一个 sheet
split_excel_by_column:按列拆分 Excel
find_excel_data:检索 Excel 内容
query4excel:按条件提取结果
excel2pdf:Excel 导出 PDF
count4page:统计打印页数
Word
merge4docx:合并多个 docx
docx2pdf:docx 转 PDF
doc2docx:doc 转 docx
docx2doc:docx 转 doc
docx4imgs:提取 docx 中的图片
PPT
ppt2pdf:PPT 转 PDF
ppt2img:PPT 转图片
merge4ppt:合并多个 PPT
PDF
add_watermark:PDF 加文字或图片水印
txt2pdf:文本转 PDF
encrypt4pdf:PDF 加密
decrypt4pdf:PDF 解密
merge2pdf:合并多个 PDF
pdf2docx:PDF 转 docx
pdf2imgs:PDF 转图片
没有足够证据的能力
以下能力不要直接假定 python-office 公开 API 已支持:
- 通用 Word 新建整份报告
- 通用 Word 段落级编辑
- 通用 PPT 新建整套演示文稿
- 通用 PPT 幻灯片级精细编辑
- 通用 PDF 段落级编辑
遇到这些需求时,改用底层编辑库处理。
分类型办事指南
Word 办公
适合:周报、方案、纪要、说明文、通知。
优先策略:
- 新建或重写:
python-docx
- 合并或转格式:
python-office
- 提图:
python-office
常见动作:
- 建标题层级
- 写正文和列表
- 插入表格
- 根据材料改写成正式文档
- 输出 docx,必要时再导出 PDF
Excel 办公
适合:台账、清单、统计表、汇总表。
优先策略:
- 新建和改单元格:
openpyxl
- 合并、拆分、查询、导出 PDF:
python-office
常见动作:
- 新建工作簿和 sheet
- 写表头和数据行
- 补统计 sheet
- 按列拆表
- 合并多份表
PPT 办公
适合:汇报稿、提案、培训材料、路演稿。
优先策略:
- 新建和改页内容:
python-pptx
- 导出 PDF / 图片、合并 PPT:
python-office
常见动作:
- 根据提纲生成封面页、要点页、结论页
- 把长文压缩成演示要点
- 重写标题与 bullet
- 导出 PDF 作为汇报附件
PDF 办公
适合:归档、加水印、加解密、合并、格式转换。
优先策略:
- 文本查看:
read_file 或 pymupdf
- 水印、加解密、合并、转 docx / 图片:
python-office
注意:
- 扫描版 PDF 默认不做 OCR
- 复杂 PDF 转 docx 可能丢版式
- 用户要“修改 PDF 内容”时,先判断是否应转 docx 后编辑再导出
依赖建议(缺了再装)
uv add python-office python-docx openpyxl python-pptx pymupdf