前言¶
在 Cursor、Claude Code 等环境里让模型「写一份 Word」，常见结果是零散脚本：中文字体没设好、表格样式各写各的，封面和正文结构也不统一。自己每次在对话里重复排版要求，成本高，也难沉淀成可复用的做法。
下面介绍 SkillHub 上的社区 Skill @user_5748365b/python-docx（版本 1.0.0）。它把 python-docx 的初始化、字体、标题层级、列表、表格、图片和封面等步骤写成标准模板，Agent 按同一套约定生成 .docx，更适合方案书、架构说明等需要固定版式的文档。
这是什么¶
python-docx 是 SkillHub 分类 office-efficiency（办公效率）下的社区 Skill，坐标 @user_5748365b/python-docx，发布者为 user_5748365b，来源为 community。页面标注 requires_api_key=false，安装后不需要额外 API Key。
Skill 本体是一份 SKILL.md：说明适用场景、依赖的 Python 模块（python-docx 及 docx.shared、docx.enum、docx.oxml.ns），并给出可直接套用的函数模板与完整示例。官方入口：
- API 坐标：https://api.skillhub.cn/user_5748365b/python-docx
- SkillHub 页面：https://www.skillhub.cn/skills/user_5748365b/python-docx
据 SkillHub 抓取数据，该 Skill 评分 100000，下载约 8740 次（腾讯云 SkillHub 镜像页显示约 8.7 千次下载，与上述数量一致）。
核心功能¶
以下内容均来自该 Skill 的 SKILL.md，只列已写明的能力。
- 文档初始化：创建
Document，并为Normal样式设置默认字体（示例使用 Microsoft YaHei，并通过qn('w:eastAsia')处理东亚字体）。 - 字体工具：
set_font(run)为每个run统一设置西文与东亚字体，避免中文显示为方框。 - 标题：
add_heading_custom支持一至三级标题，并约定字号、颜色与加粗。 - 段落：
add_para_custom支持首行缩进、加粗与颜色。 - 列表：项目符号（
List Bullet）与编号列表（List Number），带缩进级别。 - 表格：
create_table根据表头与二维数据生成表格，示例样式为Light Grid Accent 1。 - 图片：
insert_image居中插入图片，可选图注。 - 分页与封面：
add_page_break；create_cover支持主副标题、客户、日期、版本等封面信息。
文档末尾附有「常见问题」（中文方框、表格样式、图片路径、格式错乱）及 python-docx 官方文档 链接。
安装与启用¶
官方页面给出的安装方式是：让 AI 按 SkillHub 安装说明处理，坐标写为 @user_5748365b/python-docx。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5748365b/python-docx`。
若本机已有 SkillHub CLI，可先检查版本，再安装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认装到 ./skills/ 可能不会被 Agent 加载）。
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装或仅 CLI：
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
安装本 Skill（命名空间与 slug 以 skillhub search python-docx 解析结果为准）：
skillhub install python-docx --namespace user_5748365b --dir <你的 Agent skills 目录>
常见 skills 目录（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。运行 Skill 中的示例代码前，需在 Python 环境中已安装 python-docx 库（import 名为 docx）；具体安装命令以你项目环境为准，Skill 正文未单独列出 pip 行。
典型用法¶
Skill 建议的流程是：先 create_document()，再按需组封面、分页、标题、正文、列表、表格，最后 save。
下面节选官方完整示例中的调用顺序，便于对照 SKILL.md 复现（函数定义见 Skill 内各小节）。
doc = create_document()
create_cover(doc,
title='安全服务方案',
subtitle='Security Service Proposal',
customer='某某公司',
date='2026-03-23',
version='V1.0'
)
doc.add_page_break()
add_heading_custom(doc, '一、 服务概述', level=1)
add_heading_custom(doc, '1.1 服务背景', level=2)
add_para_custom(doc, '这是正文内容，首行缩进两字符。', indent=0.5)
add_bullet_custom(doc, '项目符号内容')
add_numbered_custom(doc, '编号列表内容')
headers = ['列1', '列2', '列3']
data = [['A', 'B', 'C'], ['D', 'E', 'F']]
create_table(doc, headers, data)
doc.save('output.docx')
在对话里使用时，可直接说明交付物为 .docx，并引用本 Skill，让 Agent 按上述函数名与字体设置生成脚本，而不是临时拼凑 API 调用。
适用场景与注意¶
适合谁
- 需要反复产出版式相近的 Word：安全服务方案、技术架构设计文档等（Skill 概述中写明的场景）。
- 希望 Agent 生成 Python 脚本时，默认带上中文字体与表格样式约定。
限制与注意
- Skill 聚焦「生成」与排版模板，不包含读档、修订、批注等高级 Word 能力；复杂需求可能要结合其他文档类 Skill 或自行扩展。
- 封面与配色、字号以 Skill 示例为准；企业有严格公文规范时，应在对话中补充贵司模板或替换
create_cover/add_heading_custom中的参数。 - 插入图片时需保证路径有效；Skill 建议必要时使用绝对路径。
- 每个文本
run都应走set_font()，否则易出现中文方框（Skill FAQ 已说明）。
结尾¶
@user_5748365b/python-docx 把 python-docx 写成 Agent 可遵循的一套标准模板，减少「每次对话重新讲排版」的成本。若你主要在 Cursor 等环境里做办公类自动化，可从 SkillHub 页面或上述安装命令接入，再让 Agent 按 Skill 中的函数与示例落盘为 .docx。
官方页面：https://www.skillhub.cn/skills/user_5748365b/python-docx
