前言¶
在业务里批量出 Word，常见做法是手写 python-docx 脚本，或让模型「随便写一段能跑的代码」。前者要反复查样式、目录、页眉页脚怎么设；后者容易漏中文字体、编号列表和分页，改一版就要重新对齐格式。若希望 Agent 按同一套约定处理公文、合同、报告、简历等文档，需要一个把能力写进 SKILL.md 的专用 Skill，而不是每次从零提示。
下面介绍 SkillHub 上的 Word/DOCX 中文处理助手（@kunlungrowth/cn-docx-editor），由昆仑增长发布，基于 python-docx 创建与编辑中文 DOCX，并强调可落地的脚本输出。
这是什么¶
一句话定位：面向中文 Office 文档的 Agent Skill，指导模型用 python-docx 完成标题样式、目录、表格、编号列表、分页、页眉页脚和基础修订等操作。
- 坐标：
@kunlungrowth/cn-docx-editor - 版本：1.0.0
- 来源：enterprise（SkillHub）
- 分类：office-efficiency
- 标签：
requires_api_key=false（无需 API Key） - 官方入口：SkillHub 技能页、API 坐标
它解决的是：在 Agent 对话里用自然语言描述文档结构，由 Skill 约束生成可直接运行的 Python 脚本，而不是零散代码片段。
核心功能¶
以下能力均来自官方简介，安装后由 Skill 内 SKILL.md 具体展开：
- 文档结构与样式：标题样式、分页。
- 版式与导航：目录、页眉页脚。
- 正文元素：表格、编号列表。
- 协作相关：基础修订（track changes 层面的常见处理）。
- 场景覆盖：公文、合同、报告、简历等高频模板类需求。
底层依赖为 python-docx；Skill 的价值在于把中文场景下的约定和步骤固化，减少每次对话重新对齐格式。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明与路径以 SkillHub 安装文档 为准。
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install @kunlungrowth/cn-docx-editor --dir <你的 skills 目录>
常用客户端 skills 目录（摘自官方安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可将下面提示发给已接入 SkillHub 安装流程的 AI，让其按 skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@kunlungrowth/cn-docx-editor`。
安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
官方页面未单独给出固定示例脚本；典型流程如下，与简介中「给出可直接运行的脚本」一致：
- 确认本 Skill 已装入当前 Agent 的 skills 目录。
- 在对话中用中文说明文档类型与结构，例如：一级/二级标题、是否要目录、表格列数、编号列表、页眉页脚文案、是否分页等。
- 让 Agent 按 Skill 指引生成完整的
python-docxPython 脚本（含依赖说明），在本地执行后得到.docx文件。 - 若需「基础修订」或版式微调，在同一对话中增量描述修改点，由 Agent 在脚本层调整而非手改二进制 docx。
执行脚本前，请在本机安装 python-docx（Skill 正文会按场景说明；常见方式为 pip install python-docx）。中文字体、段落间距等仍以 Skill 内约定为准，避免与 Word 默认样式冲突。
适用场景与注意¶
适合谁
- 需要用代码批量或半自动生成中文 Word 的开发者、运营、法务辅助岗位。
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作，希望文档产出可脚本化、可复现的团队。
限制与注意
- 能力边界以 python-docx 为准：复杂版式、与 Microsoft Word 专有功能完全一致的渲染，可能仍需人工在 Word 中收尾。
- Skill 提供的是工作流与脚本模板，不是在线 DOCX 编辑器；产出物是 Python 脚本与本地生成的文件。
- 安装目录错误是常见坑：务必使用
--dir指向对应客户端的 skills 路径。 - SkillHub 页面显示本技能 v1.0.0，评分与下载量会随平台更新变化；撰写时平台统计为评分 100000、下载 4213（以 SkillHub 为准）。
结尾¶
Word/DOCX 中文处理助手把中文 Word 里重复出现的结构（标题、目录、表格、列表、分页、页眉页脚、基础修订）收拢进一套 Agent Skill，让 python-docx 脚本在对话里可重复生成。若你正在 SkillHub 上找 office-efficiency 类能力，可从官方页安装 @kunlungrowth/cn-docx-editor：
- https://www.skillhub.cn/skills/kunlungrowth/cn-docx-editor
- https://api.skillhub.cn/kunlungrowth/cn-docx-editor
