// 当用户要生成 Word/Excel/PowerPoint、做文档格式转换（Markdown ↔ HTML ↔ DOCX ↔ PDF）、PDF 文本提取、读写 Excel、合并文档或批量转换时使用。
| name | doc-processor |
| description | 当用户要生成 Word/Excel/PowerPoint、做文档格式转换（Markdown ↔ HTML ↔ DOCX ↔ PDF）、PDF 文本提取、读写 Excel、合并文档或批量转换时使用。 |
| version | 2.2.0 |
| metadata | {"zhiwei":{"tags":["document","pandoc","pdf","docx","excel","conversion"],"suggested_tools":["shell.exec","code","file.read","file.write"]}} |
文档处理优先走可执行工具链：code + Python 库（python-docx / openpyxl / python-pptx / pypdf）负责生成、编辑和精细处理；shell.exec + CLI（pandoc / poppler / wkhtmltopdf / libreoffice）负责格式转换和批处理。
当前 Agent 默认只注入少量核心工具。若运行时没有 code、shell.exec、file.write 等 schema，先用 tool.search 按工具名或能力检索，发现后再执行。
file.write| 用户表达 | 路径 |
|---|---|
| 生成 Word | 优先 {skill_scripts_dir}/md2docx.py 或 code + python-docx |
| 生成 Excel | {skill_scripts_dir}/xlsx_tools.py from-csv 或 code + openpyxl |
| 生成 PPT / 幻灯片 / 演示文稿 | code + python-pptx |
| Markdown / HTML / DOCX / PDF 互转 | shell.exec + pandoc |
| PDF 文本提取 | {skill_scripts_dir}/pdf_tools.py extract-text 或 pdftotext |
| HTML → PDF | shell.exec + wkhtmltopdf / pandoc |
| 多 PDF 合并 / 拆分 | {skill_scripts_dir}/pdf_tools.py merge/split |
| 批量转换 | 先单文件验证，再 shell.exec 循环或写临时脚本 |
python -c "import ..." 或 pandoc --version。依赖缺失时说明安装命令；只有用户明确允许时才安装。file.read 抽样确认文本内容；对二进制 Office/PDF，可用脚本提取文本或列 sheet/页数。qpdf --decrypt 预处理；不要尝试绕过权限。document.create / document.edit，应使用本 Skill 的脚本、Python 库或 CLI。{skill_dir}/references/doc-conversion.md{skill_dir}/references/dependency-setup.md{skill_dir}/references/office-recipes.md{skill_dir}/references/troubleshooting.md当用户要手动创作或改写一个新的知微 Skill、需要 v2 规范示例模板、排查 description/body 校验失败原因或打磨 metadata.zhiwei 元数据时使用。
当用户要测试或调试 REST / GraphQL 接口、验证响应格式、对比接口文档与实际行为、生成 Mock 数据时使用。
当用户要控制浏览器完成需要 JavaScript 渲染、登录态或交互操作的网页任务时使用。
当用户要通过外部编码 CLI（Claude Code / Codex / Gemini）完成多文件开发、修 bug、跨模块重构、PR 审查、并行任务分发等需要后台 Agent 执行的复杂编码任务时使用。
当用户要撰写文章、报告、邮件、博客、提案、周报或对已有文本做润色改写时使用。
当用户要创建精确时间调度的定时任务（每天/每周/每小时）、周期性提醒或重复执行的 Agent 任务时使用。