word-processor

name	word-processor
description	本地 Word / DOCX 文档处理技能。支持读取、创建、编辑、模板填充、批量处理与格式转换，并在本地完成 Word 文档工作流。Use when 用户要求读取或生成 .docx、批量套模板出文档、抽取表格/元数据、替换或追加文档内容、在 Word 与 PDF/Markdown 之间转换，或明确要求“本地处理”“不要走云端”。Do not use for飞书云文档协作（优先 feishu-create-doc / feishu-update-doc）or 非 Word 文档格式的专用处理。

Word 文档处理技能

完全本地的 Word / DOCX 文档处理工具，适合本地读取、生成、修改、模板填充和批量转换。

核心能力

• 读取文本、表格、图片、元数据
• 从零创建新文档
• 编辑现有文档内容和结构
• 基于模板批量生成文档
• 批量处理多个文件
• DOCX 与 PDF / Markdown 之间转换

基本工作流

1. 准备环境

pip3 install -r requirements.txt

2. 判断任务类型

• 读取：抽取文本 / 表格 / 元数据
• 创建：从零生成新文档
• 编辑：替换、追加、插入内容
• 模板填充：用 JSON 或数据目录批量出文档
• 批量处理 / 转换：对多份文件做统一动作

3. 选择调用方式

• 命令行方式：用户只需要完成具体任务时，优先用 CLI
• Python API 方式：任务需要嵌入脚本或程序时，直接调用库

何时读取参考文档

CLI 示例

读 references/cli-recipes.md，当你需要：

• create / read / edit / template / batch 命令示例
• 常见批量处理命令
• 典型业务场景参考

Python API

读 references/python-api.md，当你需要：

• 在 Python 中直接创建 / 读取 / 编辑文档
• 模板占位符示例
• 代码级集成方式

注意事项

• 仅支持 .docx，不处理旧版 .doc
• 复杂格式（如 SmartArt）可能无法完整保留
• 宏（VBA）不会保留
• PDF 转换通常依赖 LibreOffice 等外部能力
• 若用户明确要求云端协作，改用飞书文档类技能

交付时说明

完成后应告诉用户：

• 生成或修改了哪些文件
• 输出文件在哪里
• 若涉及转换，哪些格式需要额外依赖
• 有哪些格式保真限制