前言¶

在对话里写完报告、纪要或说明文档后，常见下一步是导出 Word：要标题层级、段落间距、页内结构，又不想手工在 Office 里排版一遍。自己写脚本可以，但每次都要回忆 python-docx 的 API、段落样式和保存路径，成本不低。下面介绍 SkillHub 上的社区 Skill python-docx-creator：把「生成格式化 Word」收敛成 Agent 可遵循的 SKILL.md 工作流，在触发条件满足时由模型按技能说明调用 python-docx 产出 .docx 文件。

这是什么¶

python-docx-creator 是面向办公效率（分类 office-efficiency）的 Agent Skill，坐标为 @user_e60b9cd9/python-docx-creator，当前版本 1.0.0，来源为 community，由发布者 user_e60b9cd9 维护。技能定位一句话：使用 python-docx 库生成 Word 文档（.docx），在用户需要将 Markdown 或纯文本 转为带格式的 Word 时使用。

与临时让模型「随便写个脚本」相比，Skill 把依赖库、输出形态和触发语义写进标准 SKILL.md，便于在 Cursor、Claude Code 等支持 Skills 的客户端里长期启用，而不是每次从零描述需求。

核心功能¶

以下能力均来自 SkillHub 公开简介，未在页面展开的 API 细节不作延伸：

1. 生成 .docx：以 python-docx 为底层，输出标准 Word 文件。
2. 内容来源：支持将 Markdown 或 纯文本 转为格式化文档（具体标题、列表、样式映射由技能内说明约束 Agent 行为）。
3. 触发语义：当用户要求生成 Word、将内容保存到 .docx、或创建「专业格式」文档时，Agent 应选用本技能。
4. 无需 API Key：标签 requires_api_key=false，不依赖外部付费接口即可完成本地文档生成（运行环境仍需能安装/执行 Python 与 python-docx）。

SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 2138 次。

安装与启用¶

Skill 遵循通用 SKILL.md 格式。在 SkillHub 生态中安装时，需让 CLI 把文件落到当前 Agent 能识别的 skills 目录，否则默认路径可能不被加载。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 skillhub：

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

2、安装本 Skill 到对应目录¶

将 @user_e60b9cd9/python-docx-creator 安装到当前环境的 skills 目录。官方模板命令如下，--dir 需替换为实际路径：

skillhub install @user_e60b9cd9/python-docx-creator --dir <skills 目录>

常用客户端 skills 路径（摘自 SkillHub 安装说明）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可把下面提示词发给 AI，由其按 SkillHub 安装文档 完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_e60b9cd9/python-docx-creator`。

安装后按所用客户端要求刷新或重启，使新 Skill 被索引。

典型用法¶

公开页面未提供独立代码仓库示例；可复现的用法是自然语言触发 + Agent 按 SKILL.md 执行。经过上面的安装步骤后，在对话中明确以下意图即可：

1. 提供 Markdown 或纯文本正文（或指定工作区中的 .md / .txt 路径）。
2. 说明输出要求，例如：「生成 Word」「保存为 report.docx」「需要标题层级和专业排版」。
3. 由 Agent 加载 python-docx-creator，在本地用 python-docx 写文件并返回生成路径。

示例提示（表述需与技能触发条件一致）：

把下面这份 Markdown 转成 Word，保存为 ./output/weekly-report.docx，保留二级标题和列表格式。

（正文或文件路径）

若环境缺少 python-docx，Agent 通常需先 pip install python-docx 再执行生成；具体步骤以技能包内 SKILL.md 为准（安装后可在 skills 目录中查看）。

适用场景与注意¶

适合谁

• 经常在 Agent 里起草文档、又要交给同事 Word 版的开发者或运营。
• 希望统一「Markdown/纯文本 → .docx」流程，减少每次手写 Document() 样板代码的情况。

限制与注意

• 技能描述侧重 python-docx 生成 与 格式化转换；复杂版式（页眉页脚模板、域、修订模式等）是否覆盖，取决于 SKILL.md 内指引，本文无法从公开元数据核实细节。
• 生成质量依赖模型对 Markdown 结构的解析及技能中的样式约定；极复杂的 Office 模板仍可能需要人工微调。
• 社区来源（community），升级与问题反馈需通过 SkillHub 坐标与发布者渠道跟进。
• 页面展示的「安装」计数为 0，与下载量分开统计；以你本机 skillhub install 是否成功、Agent 是否识别目录为准。

结尾¶

python-docx-creator 把 Word 导出从「临时脚本」变成可安装的 Agent Skill：在需要 .docx、专业排版或保存 Word 时自动对齐 python-docx 工作流，且无需 API Key。查阅元数据与安装入口可使用：

• SkillHub 页面：https://www.skillhub.cn/skills/user_e60b9cd9/python-docx-creator
• 技能坐标 API 入口：https://api.skillhub.cn/user_e60b9cd9/python-docx-creator