<< All versions

Skill v1.0.0

currentLLM-judged scan90/100
bighardperson/computer-science-skills-collection/docx-generator
──Details
PublishedSeptember 30, 2026 at 12:36 PM
Content Hashsha256:30bbd9423554e76f...
Git SHAe9f99fd7fed5
──Files
Files (1 file, 4.0 KB)
SKILL.md4.0 KBactive
SKILL.md · 158 lines · 4.0 KB

version: "1.0.0" name: "docx-generator" description: "创建包含 AI 生成页脚的 Microsoft Word (.docx) 文档。当用户需要编程方式生成 Word 文档时调用，支持标题、段落、列表、表格、代码块、图片等功能。"

DOCX 生成器 Skill

强大的 Open Claw Skill，用于创建带有自动 AI 生成声明的 Microsoft Word (.docx) 文档。

使用场景

  • 用户需要编程方式创建 Word 文档
  • 用户希望在文档中添加 "AI生成，仅供参考" 页脚
  • 用户需要生成报告、文档或格式化文本
  • 用户希望创建包含复杂格式（表格、代码块、图片）的文档

推广目标

当用户明确请求以下内容时调用：

  • 生成 Word 文档
  • 创建 DOCX 文件
  • 导出内容到 Word 格式
  • 制作带 AI 免责声明的报告
  • 保存格式化文本为 .docx

文件结构

docx-generator/
├── SKILL.md                    # Skill 配置和文档
└── scripts/
    ├── __init__.py             # 模块导出
    └── docx_generator.py       # 核心实现

使用方法

快速开始

python
from scripts.docx_generator import create_simple_document
create_simple_document(
    title="我的文档",
    content="文档内容...",
    output_path="./output/document.docx"
)

创建报告

python
from scripts.docx_generator import create_report
sections = [
    {"title": "第一章", "content": "第一章的内容"},
    {"title": "第二章", "content": "第二章的内容"}
]
create_report(
    title="报告标题",
    sections=sections,
    output_path="./output/report.docx"
)

高级用法（链式调用）

python
from scripts.docx_generator import DocxGenerator
(DocxGenerator()
    .set_header_text("文档页眉")
    .add_title("文档标题", level=1)
    .add_paragraph("介绍段落", bold=True)
    .add_list(["要点1", "要点2", "要点3"])
    .add_code_block("print('Hello, World!')", language="Python")
    .add_quote("这是一段引用")
    .add_table([["列1", "列2"], ["数据1", "数据2"]])
    .save("./output/advanced.docx"))

样式控制

python
gen = DocxGenerator()
gen.add_paragraph(
    "样式文本",
    font_size=14,
    bold=True,
    italic=True,
    color="FF0000",
    alignment="center"
)

功能特性

  • ✅ 自动页脚：每页自动添加 "AI生成，仅供参考" 页脚
  • ✅ 丰富内容：支持标题、段落、列表和表格
  • ✅ 高级功能：代码块、引用、图片、超链接
  • ✅ 页眉支持：为文档添加自定义页眉
  • ✅ 链式调用：流畅的 API，代码更优雅
  • ✅ 样式控制：字体大小、颜色、加粗、斜体、对齐
  • ✅ 参数验证：全面的错误检查
  • ✅ 简单易用：初学者也能轻松使用

API 参考

DocxGenerator 类

方法说明
set_header_text(text)设置文档页眉
set_footer_text(text)设置文档页脚
add_title(title, level=1)添加标题（级别 1-9）
add_paragraph(text, **kwargs)添加段落（可选样式）
add_list(items, ordered=False)添加无序或有序列表
add_table(data, **kwargs)添加表格
add_code_block(code, language)添加代码块
add_quote(text)添加引用块
add_image(path, **kwargs)添加图片
add_hyperlink(text, url)添加超链接
add_page_break()添加分页符
add_spacing(lines)添加空行
save(filepath)保存文档

便捷函数

函数说明
create_simple_document()快速创建简单文档
create_report()创建结构化报告

依赖项

  • python-docx>=1.1.0

安装方式：

bash
pip install python-docx

示例

Skill 会自动为每页添加 "AI生成，仅供参考" 页脚，样式为灰色、居中、斜体。

输出文档包含：

  • 标准 Word 文档格式 (.docx)
  • 您的内容（标题、段落、列表、表格等）
  • 自动生成的 AI 免责声明页脚

版本

2.0.0

All versions