{"id":"747e2769-b9df-493b-a975-1f3d3c3a8b10","shortId":"bqSUJx","kind":"skill","title":"bruce-doc-converter","tagline":"双向文档转换工具，将 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) 和 PDF (.pdf) 转换为 AI 友好的 Markdown 格式，或将 Markdown (.md) 转换为 Word (.docx) 格式。当用户请求以下操作时使用：(1) 明确请求文档转换，包括任何包含\"转换\"、\"转为\"、\"转成\"、\"convert\"、\"导出\"、\"export\"等词汇的请求（例如：\"转换文档\"、\"把这个文件转为docx\"、\"convert to markdown\"、\"导出为Word\"）；(2) 需要 AI 理解文档内","description":"# Bruce Doc Converter\n\n双向文档转换工具，将 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) 和 PDF (.pdf) 转换为 AI 友好的 Markdown 格式，或将 Markdown (.md) 转换为 Word (.docx) 格式。\n\n## Quick Reference\n\n**Linux/macOS:**\n\n| 操作                   | 命令                              | 输出位置             |\n| ---------------------- | --------------------------------- | -------------------- |\n| Office/PDF → Markdown | `bash convert.sh <file>`        | 同目录 `Markdown/` |\n| Markdown → Word       | `bash convert.sh <file.md>`     | 同目录 `Word/`     |\n| 批量转换               | `bash convert.sh --batch <dir>` | 同上                 |\n\n**Windows:** 见下方 [跨平台执行方式](#跨平台执行方式)\n\n## 工作流程\n\n```\n用户请求转换 → 直接运行 bash convert.sh → 解析 JSON 输出 → 处理结果\n```\n\n**关键原则**：\n\n1. **不要预先检查任何依赖**（Python 库、Node.js 等）\n2. 直接执行转换命令\n3. 只在转换失败（`success: false`）时才根据错误信息处理\n\n## 执行命令\n\n### 跨平台执行方式\n\n**重要**：根据运行环境选择正确的执行方式：\n\n| 环境                         | 推荐命令                                                                 | 说明                           |\n| ---------------------------- | ------------------------------------------------------------------------ | ------------------------------ |\n| **Linux/macOS**        | `bash convert.sh <file>`                                               | 使用 bash 执行（无需执行权限） |\n| **Windows PowerShell** | `powershell.exe -Command \"cd '<skill-dir>' && .\\convert.ps1 '<file>'\"` | 推荐方式，支持 UTF-8 编码      |\n| **Windows Git Bash**   | `powershell.exe -Command \"cd '<skill-dir>' && .\\convert.ps1 '<file>'\"` | 在 Git Bash 中调用 PowerShell  |\n| **Windows CMD**        | `convert.bat <file>`                                                   | 传统方式，可能有编码问题       |\n\n**Claude Code 中的最佳实践**：\n\n- 在 Windows 环境（包括 Git Bash）中，始终使用 PowerShell 执行：\n  ```bash\n  powershell.exe -Command \"Set-Location '<skill-dir>'; .\\convert.ps1 'c:\\path\\to\\file.docx'\"\n  ```\n- 路径中包含空格时，使用单引号包裹\n- 使用 `Set-Location` 而不是 `cd`，避免 PowerShell 语法错误\n- `<skill-dir>` 替换为实际的 skill 目录路径（例如 `C:\\Users\\<YourName>\\.claude\\skills\\bruce-doc-converter-skill`）\n\n### 命令示例\n\n```bash\n# 单文件转换（依赖自动安装）\nbash convert.sh /path/to/document.docx\n\n# 自定义输出目录\nbash convert.sh /path/to/file.pdf true /custom/output\n\n# 批量转换\nbash convert.sh --batch /path/to/documents\n```\n\n## 解析输出\n\n脚本返回 JSON，关键字段：\n\n```json\n{\n  \"success\": true,\n  \"output_path\": \"/path/to/output.md\",\n  \"markdown_content\": \"# 转换后的内容...\"\n}\n```\n\n- `success`: 转换是否成功\n- `output_path`: 输出文件路径\n- `markdown_content`: Markdown 内容（方便直接分析）\n- `error`: 错误信息（失败时）\n\n## 错误处理\n\n**仅在转换失败时（返回 `success: false`）才处理错误**：\n\n| 错误类型                   | 处理方法                                                                                       |\n| -------------------------- | ---------------------------------------------------------------------------------------------- |\n| Python 依赖缺失            | 脚本会自动安装，如失败则运行 `pip install --user xxx`                                        |\n| `未找到 Node.js`         | 仅在 MD→DOCX 转换失败且报此错误时，才提示安装 Node.js                                         |\n| `Node.js 依赖未安装`     | 脚本会自动安装到用户级共享目录；失败时在 `scripts/md_to_docx` 或共享目录运行 `npm install` |\n| `文件不存在`             | 提示用户验证文件路径                                                                           |\n| `不支持的文件格式: .doc` | 提示用户先转换为 .docx                                                                         |\n| `文件过大`               | 提示超过 100MB 限制                                                                            |\n\n## 支持的格式\n\n| 格式  | 转换方向 | 质量            |\n| ----- | -------- | --------------- |\n| .docx | ↔       | 优秀            |\n| .xlsx | →       | 优秀            |\n| .pptx | →       | 良好            |\n| .pdf  | →       | 取决于 PDF 类型 |\n| .md   | ↔       | 优秀            |\n\n## 注意事项\n\n**重要：**\n\n- **绝对不要在执行转换前检查任何依赖**（包括 Python、Node.js、npm 包等）\n- 直接执行转换命令，让脚本自己检测和处理依赖\n- 只在转换失败时才根据返回的错误信息采取行动\n\n其他：\n\n- Python 依赖会自动安装到用户目录\n- Node.js 依赖会自动安装到用户级共享目录（可用 `BRUCE_DOC_CONVERTER_NODE_HOME` 指定）\n- 默认共享目录：macOS/Linux `~/.bruce-doc-converter/node/md_to_docx`，Windows `%LOCALAPPDATA%\\BruceDocConverter\\node\\md_to_docx`\n- .doc/.xls/.ppt 旧格式需先转换为对应的新格式","tags":["bruce","doc","converter","bruc3van","agent-skills","doc-converter","markdown2docx"],"capabilities":["skill","source-bruc3van","skill-bruce-doc-converter","topic-agent-skills","topic-doc-converter","topic-markdown2docx"],"categories":["bruce-doc-converter"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/bruc3van/bruce-doc-converter","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add bruc3van/bruce-doc-converter","source_repo":"https://github.com/bruc3van/bruce-doc-converter","install_from":"skills.sh"}},"qualityScore":"0.472","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 44 github stars · SKILL.md body (3,962 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T18:58:13.748Z","embedding":null,"createdAt":"2026-04-18T23:56:44.544Z","updatedAt":"2026-04-22T18:58:13.748Z","lastSeenAt":"2026-04-22T18:58:13.748Z","tsv":"'-8':149 '/.bruce-doc-converter/node/md_to_docx':343 '/custom/output':228 '/path/to/document.docx':222 '/path/to/documents':233 '/path/to/file.pdf':226 '/path/to/output.md':243 '1':29,113 '100mb':300 '2':46,119 '3':121 'ai':17,48,65 'bash':84,90,95,106,134,137,153,160,176,181,217,220,224,230 'batch':97,232 'bruce':2,50,212,335 'bruce-doc-convert':1 'bruce-doc-converter-skil':211 'brucedocconvert':346 'c':188,207 'cd':144,156,199 'claud':168,209 'cmd':164 'code':169 'command':143,155,183 'content':245,253 'convert':4,35,42,52,214,337 'convert.bat':165 'convert.ps1':145,157,187 'convert.sh':85,91,96,107,135,221,225,231 'doc':3,51,213,295,336 'doc/.xls/.ppt':351 'docx':8,26,56,74,280,297,306,350 'error':257 'excel':9,57 'export':37 'fals':124,264 'file.docx':191 'git':152,159,175 'home':339 'instal':273,291 'json':109,236,238 'linux/macos':78,133 'localappdata':345 'locat':186,197 'macos/linux':342 'markdown':19,22,44,67,70,83,87,88,244,252,254 'md':23,71,279,316,348 'node':338,347 'node.js':117,277,283,284,323,332 'npm':290,324 'office/pdf':82 'output':241,249 'path':189,242,250 'pdf':14,15,62,63,312,314 'pip':272 'powerpoint':11,59 'powershel':141,162,179,201 'powershell.exe':142,154,182 'pptx':12,60,310 'python':115,268,322,330 'quick':76 'refer':77 'scripts/md_to_docx':288 'set':185,196 'set-loc':184,195 'skill':204,210,215 'skill-bruce-doc-converter' 'source-bruc3van' 'success':123,239,247,263 'topic-agent-skills' 'topic-doc-converter' 'topic-markdown2docx' 'true':227,240 'user':208,274 'utf':148 'window':99,140,151,163,172,344 'word':7,25,55,73,89,93 'xlsx':10,58,308 'xxx':275 '不支持的文件格式':294 '不要预先检查任何依赖':114 '中':177 '中的最佳实践':170 '中调用':161 '仅在':278 '仅在转换失败时':261 '优秀':307,309,317 '传统方式':166 '使用':136,194 '使用单引号包裹':193 '例如':39,206 '依赖会自动安装到用户目录':331 '依赖会自动安装到用户级共享目录':333 '依赖未安装':285 '依赖缺失':269 '依赖自动安装':219 '关键原则':112 '关键字段':237 '其他':329 '内容':255 '包括':174,321 '包括任何包含':31 '包等':325 '单文件转换':218 '友好的':18,66 '双向文档转换工具':5,53 '取决于':313 '只在转换失败':122 '只在转换失败时才根据返回的错误信息采取行动':328 '可用':334 '可能有编码问题':167 '同上':98 '同目录':86,92 '命令':80 '命令示例':216 '和':13,61 '在':158,171 '处理方法':267 '处理结果':111 '失败时':259 '失败时在':287 '如失败则运行':271 '始终使用':178 '导出':36 '导出为word':45 '将':6,54 '工作流程':103 '库':116 '当用户请求以下操作时使用':28 '或共享目录运行':289 '或将':21,69 '才处理错误':265 '才提示安装':282 '执行':138,180 '执行命令':126 '批量转换':94,229 '把这个文件转为docx':41 '指定':340 '推荐命令':131 '推荐方式':146 '提示用户先转换为':296 '提示用户验证文件路径':293 '提示超过':299 '操作':79 '支持':147 '支持的格式':302 '文件不存在':292 '文件过大':298 '方便直接分析':256 '无需执行权限':139 '旧格式需先转换为对应的新格式':352 '时才根据错误信息处理':125 '明确请求文档转换':30 '替换为实际的':203 '未找到':276 '根据运行环境选择正确的执行方式':129 '格式':20,27,68,75,303 '注意事项':318 '环境':130,173 '理解文档内':49 '用户请求转换':104 '目录路径':205 '直接执行转换命令':120,326 '直接运行':105 '等':118 '等词汇的请求':38 '类型':315 '绝对不要在执行转换前检查任何依赖':320 '编码':150 '而不是':198 '脚本会自动安装':270 '脚本会自动安装到用户级共享目录':286 '脚本返回':235 '自定义输出目录':223 '良好':311 '见下方':100 '解析':108 '解析输出':234 '让脚本自己检测和处理依赖':327 '语法错误':202 '说明':132 '质量':305 '跨平台执行方式':101,102,127 '路径中包含空格时':192 '转为':33 '转成':34 '转换':32 '转换为':16,24,64,72 '转换后的内容':246 '转换失败且报此错误时':281 '转换文档':40 '转换方向':304 '转换是否成功':248 '输出':110 '输出位置':81 '输出文件路径':251 '返回':262 '避免':200 '重要':128,319 '错误信息':258 '错误处理':260 '错误类型':266 '限制':301 '需要':47 '默认共享目录':341","prices":[{"id":"4e2c2f83-e8bb-45c4-9ff7-fa972fd95d44","listingId":"747e2769-b9df-493b-a975-1f3d3c3a8b10","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"bruc3van","category":"bruce-doc-converter","install_from":"skills.sh"},"createdAt":"2026-04-18T23:56:44.544Z"}],"sources":[{"listingId":"747e2769-b9df-493b-a975-1f3d3c3a8b10","source":"github","sourceId":"bruc3van/bruce-doc-converter","sourceUrl":"https://github.com/bruc3van/bruce-doc-converter","isPrimary":false,"firstSeenAt":"2026-04-18T23:56:44.544Z","lastSeenAt":"2026-04-22T18:58:13.748Z"}],"details":{"listingId":"747e2769-b9df-493b-a975-1f3d3c3a8b10","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"bruc3van","slug":"bruce-doc-converter","github":{"repo":"bruc3van/bruce-doc-converter","stars":44,"topics":["agent-skills","doc-converter","markdown2docx"],"license":null,"html_url":"https://github.com/bruc3van/bruce-doc-converter","pushed_at":"2026-04-10T11:54:50Z","description":"为 Claude Code / OpenClaw 添加双向文档转换能力。支持 Word/Excel/PPT/PDF ↔ Markdown，导出精美 Word 文档。","skill_md_sha":"4738f667b6853bc56543dd714b5ccba629449691","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/bruc3van/bruce-doc-converter"},"layout":"root","source":"github","category":"bruce-doc-converter","frontmatter":{"name":"bruce-doc-converter","description":"双向文档转换工具，将 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) 和 PDF (.pdf) 转换为 AI 友好的 Markdown 格式，或将 Markdown (.md) 转换为 Word (.docx) 格式。当用户请求以下操作时使用：(1) 明确请求文档转换，包括任何包含\"转换\"、\"转为\"、\"转成\"、\"convert\"、\"导出\"、\"export\"等词汇的请求（例如：\"转换文档\"、\"把这个文件转为docx\"、\"convert to markdown\"、\"导出为Word\"）；(2) 需要 AI 理解文档内容（\"帮我分析这个 Word 文件\"、\"读取这个 PDF\"、\"总结这个 Excel\"）；(3) 上传文档文件并询问内容（\"这是什么\"、\"帮我看看\"）；(4) 任何涉及 .docx、.xlsx、.pptx、.pdf、.md 文件格式转换的请求。"},"skills_sh_url":"https://skills.sh/bruc3van/bruce-doc-converter"},"updatedAt":"2026-04-22T18:58:13.748Z"}}