name: python-docx-creator description: "使用 python-docx 库生成 Word 文档(.docx)。当用户需要将 Markdown 或纯文本内容转换为格式化的 Word 文档时使用此技能。触发条件包括：要求生成 Word 文档、将内容保存到 .docx 文件、创建专业格式的文档。"

python-docx-creator

使用 python-docx 库将 Markdown 或纯文本内容转换为格式化的 Word 文档。

快速开始

核心脚本

使用 scripts/create_docx.py 生成 Word 文档：

# 从文本创建
python3 scripts/create_docx.py --title "标题" --text "# 内容\n\n段落文本" --output output.docx

# 从文件创建
python3 scripts/create_docx.py --title "标题" --input input.md --output output.docx

功能特性

支持的 Markdown 格式

• 标题：# H1、## H2、### H3
• 无序列表：- 项目 或 * 项目
• 有序列表：1. 项目、2. 项目
• 粗体：**粗体文本** 或 __粗体文本__
• 斜体：*斜体文本* 或 _斜体文本_
• 普通段落：自动识别并添加

脚本参数

*注：--input 和 --text 至少提供一个

使用流程

1. 检查依赖

python3 -c "import docx; print('python-docx installed')" 2>&1 || echo "NOT_INSTALLED"

如果未安装，运行：

pip install python-docx

2. 准备内容

选项 A：从文件读取

# 文档标题

## 章节一

这是第一段内容。

- 列表项1
- 列表项2

**重点内容** 和 *强调内容*

选项 B：直接使用文本 在命令行中传递 Markdown 格式的文本内容。

3. 生成文档

# 示例：生成知识库说明文档
python3 scripts/create_docx.py \
  --title "什么是知识库？" \
  --text "# 什么是知识库？\n\n知识库是结构化存储、组织和检索知识的系统...\n\n## 从产品视角看\n\n1. 企业知识库\n2. AI 知识库" \
  --output /Users/apple/Desktop/输出文档.docx

4. 验证输出

ls -lh <output-file>.docx

常见使用场景

场景1：将回答保存为 Word 文档

当用户要求"把输出结果转换为 Word 文档并保存"时：

1. 提取需要保存的回答内容

   发现更多技能插件，请访问7w4.net。

2. 格式化为 Markdown
3. 调用 create_docx.py 生成 .docx 文件
4. 保存到用户指定路径（如桌面）

场景2：批量生成文档

# 循环生成多个文档
for file in *.md; do
  python3 scripts/create_docx.py \
    --input "$file" \
    --output "${file%.md}.docx"
done

注意事项

• 编码：脚本使用 UTF-8 编码，支持中文内容
• 格式限制：当前版本不支持表格、图片、页眉页脚等高级格式
• 路径：输出路径需要用户有写权限

扩展方向

如需支持更多 Word 格式（表格、图片、样式等），可以扩展 create_docx.py：

• 添加表格支持：使用 doc.add_table()
• 添加图片支持：使用 doc.add_picture()
• 添加样式定制：修改 doc.styles

参考资料

• python-docx 官方文档：https://python-docx.readthedocs.io/
• Markdown 语法参考：https://www.markdownguide.org/basic-syntax/

这个 Skill 质量中规中矩，文档写得清楚明了，新手也能快速上手使用。优点是功能专注、界面简洁，能满足基本的文档转换需求。缺点是功能比较单一，不支持表格、图片这类常用格式，也没有测试保障稳定性。如果只是偶尔需要转几份简单的文档，可以用；但如果对文档格式要求较高，可能不太够用。