前言¶
在 Cursor、Claude Code 等环境里让模型「写一份 Word」，常见结果是 Markdown 或结构混乱的导出文件：目录、修订痕迹、批注、页眉页脚很难一次做对。自己写脚本则要同时应付 OOXML、docx-js 的坑，以及解包改 XML 再打包的流水线。
下面介绍 SkillHub 上的 DOCX 创建、编辑与分析（@org-02qudk26/docx，v1.0.0）。它用标准 SKILL.md 把读、建、改、验 Word 文档的步骤和命令写进 Agent 上下文，用户只需用自然语言描述需求，由 Agent 按技能内的流程执行。
这是什么¶
DOCX 创建、编辑与分析 是面向 .docx 的 Agent Skill：当任务涉及创建、读取、编辑或操作 Word 文档时，应优先加载本技能。
| 项 | 说明 |
|---|---|
| 坐标 | @org-02qudk26/docx |
| 版本 | 1.0.0 |
| 发布者 | 智雨科技 |
| 来源 | enterprise（SkillHub） |
| 分类 | office-efficiency |
| 标签 | requires_api_key=false（无需额外 API Key） |
| SkillHub 页面 | https://www.skillhub.cn/skills/org-02qudk26/docx |
| 技能 API 地址 | https://api.skillhub.cn/org-02qudk26/docx |
技能包内 README 将能力概括为：创建、读取、编辑和验证专业 Word 文档，覆盖样式、目录、表格、页眉页脚、图片、批注、修订与 OOXML 级编辑。
核心功能¶
以下内容来自技能包 SKILL.md 与配套脚本，安装后 Agent 会按该文档路由任务。
触发范围¶
除「Word doc」「.docx」等字面提及外，技能说明还覆盖：生成带目录、标题、页码或信头的正式文档；从 .docx 提取或重组内容；插入或替换图片；查找替换；处理修订痕迹或批注；以 report、memo、letter、template 等形式交付 .docx。明确不用于 PDF、电子表格、Google Docs 等与 Word 生成无关的通用编码。
三类主路径¶
技能将 .docx 视为「XML 文件的 ZIP 包」，按任务选方法：
| 任务 | 方法 |
|---|---|
| 读取 / 分析 | pandoc，或解包读取原始 XML |
| 创建新文档 | docx-js（npm 包 docx） |
| 编辑已有文档 | 解包 → 改 XML → 重新打包 |
读取与预览¶
- 带修订的文本：
pandoc --track-changes=all document.docx -o output.md - 解包：
python scripts/office/unpack.py document.docx unpacked/ - 转 PDF / 分页图：
scripts/office/soffice.py与pdftoppm（技能内写明用于验证排版）
创建新文档¶
通过 Node 脚本调用 docx 库生成文件，并用 python scripts/office/validate.py 校验。文档中强调页面尺寸（默认 A4）、表格双重宽度、列表用编号配置而非 Unicode 项目符号、ImageRun 必须带 type、目录需 HeadingLevel 等易错点。
编辑已有文档¶
固定三步：
python scripts/office/unpack.py document.docx unpacked/- 编辑
unpacked/word/下 XML；批注可用python scripts/comment.py；修订痕迹需符合 OOXML 模式 python scripts/office/pack.py unpacked/ output.docx --original document.docx
旧版 .doc 需先转换：
python scripts/office/soffice.py --headless --convert-to docx document.doc
接受全部修订可执行：
python scripts/accept_changes.py input.docx output.docx
依赖¶
技能列出的运行时依赖：pandoc、docx（npm install -g docx）、LibreOffice（经 scripts/office/soffice.py）、Poppler 的 pdftoppm。
安装与启用¶
安装流程以 SkillHub 官方说明为准：https://skillhub.cn/install/skillhub.md 。技能详情页给出的安装坐标为 @org-02qudk26/docx。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装技能到当前 Agent 的 skills 目录¶
必须用 --dir 指向 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不被加载。
skillhub install @org-02qudk26/docx --dir <skills 目录>
常见路径（以官方文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装成功后，本机目录结构类似：.../@org-02qudk26/docx/SKILL.md 及 scripts/ 等共 22 个文件（与平台签名元数据中的 file_count 一致）。
3、（可选）校验包完整性¶
SkillHub 支持对已安装版本验签，需 CLI 版本不低于 2026.7.29：
skillhub self-upgrade
skillhub verify @org-02qudk26/docx
通过时终端会提示签名与内容校验通过；具体含义见 https://skillhub.cn/docs/verify-signature?namespace=org-02qudk26&slug=docx&version=1.0.0 。
4、在对话中启用¶
向 Agent 说明需求即可，例如：「请根据 https://skillhub.cn/install/skillhub.md，安装 @org-02qudk26/docx。」安装并重启或刷新技能加载后，提及 Word / .docx 的任务应自动命中本技能。
典型用法¶
自然语言驱动¶
安装完成后，可直接描述业务目标，由 Agent 选择读、建、改路径。技能包 README 中的示例场景包括：合同草稿统一标题与目录；处理带修订的客户文档；报告插图与脚注并做渲染验证。这些是技能内文档给出的说明，而非第三方案例。
读取现有文档为 Markdown¶
pandoc --track-changes=all document.docx -o output.md
适合先摸清正文与修订内容，再决定是否解包改 XML。
从零生成并校验¶
Agent 按 SKILL.md 编写 docx-js 脚本生成 doc.docx，然后：
python scripts/office/validate.py doc.docx
若需目视检查，技能建议先转 PDF 再分页导出图片（命令见 SKILL.md「转换为图片」一节）。
解包编辑后回写¶
python scripts/office/unpack.py document.docx unpacked/
# 编辑 unpacked/word/document.xml 等
python scripts/office/pack.py unpacked/ output.docx --original document.docx
批注可配合：
python scripts/comment.py unpacked/ 0 "批注正文（注意 XML 转义）"
适用场景与注意¶
适合谁
- 经常在 Agent 里交付
.docx的开发者、法务、运营、咨询等角色 - 需要修订痕迹、批注、OOXML 级改动，而不只是「导出一段文字」的团队
- 已使用 Cursor / Claude Code / Codex 等支持 Skill 目录的客户端的用户
限制与注意
- 技能明确不处理 PDF、表格文件、Google Docs；
.doc必须先转.docx - 创建文档依赖 Node 与全局或可用的
docx包；预览与转换依赖 LibreOffice、pandoc、Poppler，环境缺组件时对应步骤会失败 - 编辑路径要求遵守 OOXML 与技能中的 schema 顺序说明；打包阶段的自动修复只能处理部分问题（如部分 ID、空白保留），不能替代合法 XML
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 37141；enterprise 技能与公开 registry 的安装方式一致，均通过
skillhub install @org-02qudk26/docx
结尾¶
DOCX 创建、编辑与分析 把 Word 文档在 Agent 场景下的标准流水线写进 SKILL.md：读用 pandoc/解包，建用 docx-js，改用解包—编辑—打包，并附带校验、批注与修订的脚本约定。若你的工作流里频繁出现 .docx，可通过 SkillHub 安装 @org-02qudk26/docx，减少每次从零摸索 OOXML 的成本。
官方入口：
- SkillHub 详情：https://www.skillhub.cn/skills/org-02qudk26/docx
- 技能 API：https://api.skillhub.cn/org-02qudk26/docx
- 安装说明：https://skillhub.cn/install/skillhub.md
