name: word-style-cleaner description: "清理 Word (.docx) 文件中未使用的文字样式。当用户要求清理 Word 文档样式、删除多余样式、简化样式列表、或提到样式面板太乱时使用此 Skill。支持单个文件或批量文件夹操作。保留正文、标题1-5、表格样式及文档中实际使用的样式，删除 heading 6-9、TOC、批注、字体残留等垃圾样式。" agent_created: true

docx-clean-styles — Word 样式清理

触发条件

当用户提到以下任一意图时触发：

• "清理Word样式" / "删除多余样式" / "简化样式列表"
• "样式面板太乱" / "不相关的文字样式删掉"
• "把 XXX.docx 里没用的样式去掉"
• 指定一个 .docx 文件或文件夹，要求"只保留正文和标题"

使用方式

直接运行内置脚本，一键完成解压→分析→清理→打包全流程。

清理单个文件

python scripts/clean_styles.py "D:/path/to/document.docx"

清理文件夹下所有 .docx

python scripts/clean_styles.py "D:/path/to/folder/"

清理多个文件

python scripts/clean_styles.py "D:/a.docx" "D:/b.docx" "D:/c.docx"

保留策略

脚本默认保留以下样式，其余全部删除：

删除内容

• heading 6-9 + 对应字符样式
• TOC1-TOC9（目录样式）
• 批注/批注主题/annotation 全套
• font5-font12（字体残留样式）
• xl65-xl79（Excel 导入残留）
• Title、Subtitle、表单、列表段落等未使用样式

注意事项

• 脚本依赖 docx 插件的 unpack.py 和 pack.py，如果路径变化需更新脚本顶部常量
• 操作直接覆盖原文件，建议先备份
• 保留策略如需调整（如只保留标题1-3），修改脚本中 BASE_KEEP_IDS 集合即可

这是一个功能专一的 Word 样式清理工具，能有效删除多余样式并保留必要的正文、标题、表格等样式。代码质量较好，处理了页眉页脚和动态检测实际使用样式等细节。但存在两个明显不足：一是脚本会直接覆盖原文件，操作有风险；二是依赖固定的插件路径，可能在某些环境下无法运行。总体质量中等，功能实用但安全性需加强。