DOCX 文档处理技能
在 .docx 文件中创建、编辑和分析内容,支持修订和批注,保留格式。
技能主要进行文档本地处理,不涉及网络外传或危险操作。但缺少明确的用户确认机制,例如在执行大规模编辑或删除前未要求用户确认;且处理敏感文档时未说明数据保密措施。依赖的第三方工具(如soffice)存在安全风险,但未明确说明隔离措施。依赖清单中提及defusedxml用于安全解析,体现安全意识,但整体权限和确认机制不完整,故得12分。
技能文档提供了详细的工作流程和脚本,但未经实际执行验证。存在多个依赖(pandoc、docx、LibreOffice等),缺失时可能失败,且未提供自动安装或错误处理。脚本如pack.py有基本错误处理,但整体故障反馈有限。静态评估限制,无法证明关键路径可复现,故得7分。
技能清晰定义了适用场景(创建、编辑、分析docx),并有决策树指导。但边界声明不明确,例如对复杂文档格式的支持程度未说明。环境适配方面,依赖工具可能受网络影响,但未强调大陆网络可达性。中英文本文档存在,但英文为主,中文支持未说明。故得10分。
文档结构清晰,分章节概述和详细指南,提供了依赖安装说明和示例代码。但许可证声明为Proprietary,与仓库Apache-2.0不符,且缺少版本和变更记录。未提供维护责任人或更新路径。信息架构尚可,但治理不完整,故得10分。
技能提供了完整的工作流程和示例,理论上能完成文档任务。但缺少验证性证据,如测试用例或实际输出示例。静态评估下,无法确认输出直接可用,边际价值有限。故得7分。
包含了可审计的脚本(如pack.py、unpack.py、validate.py),但未见测试套件或CI针对该技能。关键声明(如文档创建可靠性)缺乏第三方验证。静态评估限制,未发现独立复现证据,故得5分。
- 静态评估,未执行任何代码;建议在实际环境中验证脚本和依赖。
- 许可证不一致:技能头部声明Proprietary,而仓库为Apache-2.0,使用前需确认。
- 依赖工具(如LibreOffice)可能未预装,且网络受限时安装可能困难。
- 技能涉及文档编辑,若处理敏感内容,建议在隔离环境执行并明确数据保护措施。
这个 Skill 能做什么,适合哪些场景?
本技能为处理 Word 文档 (.docx) 提供全面的工作流。它利用 OOXML 结构,可提取文本、创建新文档、进行基本编辑,并实现带有跟踪更改的协作式文档审阅。该技能包含用于解压和重新打包文档的脚本,以及用于程序化操作的 Python 文档库和 docx-js 库。它特别适合需要精确变更跟踪的专业场景。
本技能可读取 Word 文档内容(通过 pandoc 转 markdown 或直接解压 XML)、创建新文档(使用 docx-js)、编辑现有文档(使用 Python Document 库进行简单修改或复杂的 OOXML 操作)、管理修订(插入/删除标记),以及将文档转换为图像用于视觉分析(通过 LibreOffice 和 pdftoppm)。
- 需要快速提取文档文本并进行结构保留的用户。
- 希望从零创建格式化 Word 文件的开发者。
- 需要以最小侵入精确修改合同或报告的办公人员。
- 法律或学术审核人员需要标记对共享文档的更改。
- 需要将 Word 页面转换为图像以进行视觉检查的分析师。
这个 Skill 有哪些优点和局限?
- 全面的文档处理覆盖:创建、编辑、修订、注释、提取。
- 强制遵循最佳工作流程(例如,对他人文档进行修订)。
- 包含详细的决策树,帮助根据任务选择正确的方法。
- 提供实用脚本(unpack.py、pack.py)实现稳健的 OOXML 处理。
- 支持高级场景的原始 XML 访问。
- 专有许可;不包含在仓库的 Apache-2.0 许可证中。
- 需要安装多个外部依赖(pandoc、LibreOffice、Node.js 等)。
- 对于复杂编辑,需要掌握 OOXML 和 XML 操作知识的较高技术门槛。
- 在非 Linux 平台(例如 Windows、macOS)上的测试情况未记录;命令主要为 Linux 风格。
- 未提供自动测试套件来验证不同文档结构的健壮性。
如何安装这个 Skill?
从 GitHub 克隆仓库 (https://github.com/modelscope/ms-agent),技能位于 examples/skills/claude_skills/docx/。按需安装依赖:pandoc、npm 包 'docx'、Python 包 'defusedxml'、LibreOffice 和 poppler-utils。
如何使用这个 Skill?
将 SKILL.md 及其关联文件放置在您的 Agent 技能目录中。然后,使用描述性语言进行请求,例如:“读取文件 report.docx 并提取文本”或“在 agreement.docx 中修改条款 12,并显示修订。”该技能会选择合适的工作流程:提取、创建、编辑或修订。