name: docx-report-generator description: "Word報告自動生成神器。自動生成專業Word文件報告，支援模板填充、目錄生成、表格/圖表插入、頁首頁尾、多級標題、樣式主題、批次郵件合併。當用戶需要生成Word報告、建立合同文件、批次生成通知/證書、填充Word模板、製作商業計劃書時觸發。"

DOCX Report Generator

Word文件報告自動生成工具，從模板到成品一站式搞定。

核心能力

1. 模板填充 - 用資料自動填充Word模板中的佔位符
2. 從頭建立 - 用程式碼生成完整的專業報告文件
3. 郵件合併 - 批次生成個性化文件（通知、證書、合同）
4. 目錄生成 - 自動根據標題層級生成目錄
5. 表格插入 - 建立格式化表格，支援合併單元格
6. 圖表插入 - 在文件中嵌入資料圖表
7. 樣式主題 - 自定義文件樣式和配色方案
8. 批次輸出 - 批次生成、批次匯出PDF

快速開始

從模板填充

python3 scripts/docx_ops.py fill-template template.docx --data data.json -o report.docx

建立報告

python3 scripts/docx_ops.py create-report --title "月度銷售報告" --config report_config.json -o report.docx

批次郵件合併

python3 scripts/docx_ops.py mail-merge template.docx --data recipients.csv -o output/

新增目錄

python3 scripts/docx_ops.py add-toc report.docx -o report_with_toc.docx

匯出PDF

python3 scripts/docx_ops.py to-pdf report.docx -o report.pdf
7w4.net小蔥技能站收錄全網優質技能，值得收藏。

模板語法

模板中使用 {{變數名}} 作為佔位符，支援:

• {{公司名稱}} - 簡單文本替換
• {{#表格}}...{{/表格}} - 迴圈生成行
• {{日期:format=YYYY-MM-DD}} - 格式化日期

詳見 references/template-syntax.md

依賴安裝

pip install python-docx jinja2 pandas
# 匯出PDF需要: sudo apt install libreoffice

報告配置

建立報告的配置JSON格式見 references/report-config.md

這個 Skill 質量中規中矩，完成度尚可。它提供了模板填充、批次生成、PDF匯出等實用功能，文件說明也比較清晰，容易上手。但不足之處也比較明顯：缺少基本的錯誤處理，檔案不存在或格式錯誤時容易崩潰；部分功能比較簡單，目錄功能需要手動在 Word 中更新才能顯示；模板語法只支援簡單佔位符替換，不支援條件判斷和迴圈等進階功能。總的來說，可以滿足基礎的 Word 文件生成需求，但對於複雜場景可能力不從心。