chi111i Word Power Tools
本 Skill 的目标：让 Claude Code 在本地（Linux/macOS/Windows）把 Word 文档当作可编程文档来可靠处理。
⚠️ 核心原则
必须优先使用本 Skill 提供的脚本 scripts/word_tool.py，最好不要自己编写临时脚本或一次性代码。
所有文档操作都应通过 word_tool.py 的子命令完成，确保可复现性和稳定性。
适用场景（触发关键词）
- “把 docx/doc 转 pdf/markdown/html/txt”
- “从 Word 提取表格/图片/章节结构/正文文本”
- “论文排版、格式统一、目录、页码、页眉页脚”
- “批量替换、合并、拆分、套模板”
- “格式审查（页边距、字体、行距、标题层级）并输出报告”
原则（减少风险 + 提高可复现性）
- 默认不覆盖原文件：所有会改写的操作必须写到新输出文件（
-o/--output）。 - 先 lint 后 format：排版类任务先生成报告，再应用修复（避免"修坏了但不知道改了什么"）。
- 复杂任务用脚本输出：脚本可"零上下文执行"，输出更稳定、可测试。
Quickstart
依赖自检（推荐每个新环境先跑一次）：
python scripts/word_tool.py doctor
文档概览：
python scripts/word_tool.py info path/to/file.docx
python scripts/word_tool.py outline path/to/file.docx
提取：
python scripts/word_tool.py extract-text path/to/file.docx -o out.txt
python scripts/word_tool.py extract-tables path/to/file.docx -o tables/ --format xlsx
python scripts/word_tool.py extract-images path/to/file.docx -o images/
转换：
python scripts/word_tool.py convert input.doc --to docx -o output.docx
python scripts/word_tool.py convert input.docx --to pdf -o output.pdf
python scripts/word_tool.py convert input.docx --to md -o output.md
批量替换（YAML 规则）：
python scripts/word_tool.py replace input.docx --rules templates/replace_rules.example.yaml -o replaced.docx
写入元数据（作者/标题等）：
python scripts/word_tool.py set-metadata input.docx --metadata templates/metadata.example.yaml -o meta.docx
插入目录（TOC 字段，需要在 Word 里“更新域”才能渲染）：
python scripts/word_tool.py toc input.docx --levels 1-3 -o with_toc.docx
排版校验 + 应用统一格式（YAML 配置）：
python scripts/word_tool.py lint input.docx --config templates/format_thesis_qfnu_science.yaml -o report.md
python scripts/word_tool.py format input.docx --config templates/format_thesis_qfnu_science.yaml -o fixed.docx
合并/拆分：
python scripts/word_tool.py merge a.docx b.docx c.docx -o merged.docx
python scripts/word_tool.py split input.docx --by heading1 -o split_out/
生成新文档骨架（论文/报告模板化）：
python scripts/word_tool.py new --template templates/thesis_skeleton.example.yaml -o thesis.docx
参考文档（按需读取）
- 安装与环境：
docs/INSTALL.md - 使用手册（所有子命令）：
docs/USAGE.md - 排版规则配置：
docs/FORMAT_RULES.md - 常见问题：
docs/TROUBLESHOOTING.md - 安全注意事项：
docs/SECURITY.md