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 質量中規中矩，文件寫得清楚明瞭，新手也能快速上手使用。優點是功能專注、介面簡潔，能滿足基本的文件轉換需求。缺點是功能比較單一，不支援表格、圖片這類常用格式，也沒有測試保障穩定性。如果只是偶爾需要轉幾份簡單的文件，可以用；但如果對文件格式要求較高，可能不太夠用。