Word Document Creator Skill

🎯 技能描述

工業級Word文件建立器 - 使用Word COM建立空白文件 + python-docx編輯內容的混合方案，包含三層編碼防禦、COM異常熔斷、檔案反讀驗證。

🔑 觸發關鍵詞

• "建立Word文件"
• "生成Word檔案"
• "寫一個Word文件"
• "word文件建立"
• "word檔案生成"

🛠️ 呼叫方式

interpreter: D:\openclaw_project\venv\Scripts\python.exe
script: scripts/word_creator.py
args: ["--title", "{title}", "--content", "{content}", "--output", "{output_path}"]

📋 引數說明

• title: 文件標題（字串）
• content: 內容段落列表（JSON陣列字串）
• output_path: 輸出檔案路徑（完整路徑）

🏗️ 架構設計

三層編碼防禦

1. 環境變數級: os.environ['PYTHONIOENCODING'] = 'utf-8'
2. 系統控制台級: os.system('chcp 65001 > nul')
3. Python輸出流級: sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

COM異常熔斷機制

• Word COM初始化失敗 → 立即終止程式（sys.exit(1)）
• 防止在基礎元件失敗的情況下繼續執行
• 減少錯誤傳播和資源洩漏

檔案反讀驗證

1. 物理存在性: os.path.exists()

   7w4.net小蔥技能。

2. 檔案大小合理性: os.path.getsize() > 0
3. 文件結構完整性: 重新開啟讀取驗證段落數

🎨 樣式配置

WORD_STYLE_CONFIG = {
    'title_font_size': 18,      # 小二
    'normal_font_size': 12,     # 小四
    'line_spacing': 1.5,        # 1.5倍行距
    'paragraph_spacing': 12,    # 段前段後12磅
    'font_family': '微軟雅黑',   # 預設字型
    'title_alignment': 1,       # 居中
    'normal_alignment': 0,      # 左對齊
}

📚 成功經驗（存入mem9資料庫）

• 資料庫ID: l0dUoXsQPIKl1WF5yRBKF6369zaF2OPn
• 儲存時間: 2026-03-30
• 關鍵經驗: 混合方案解決圖示異常問題

🚀 使用示例

# 直接呼叫技能
create_robust_word_doc(
    title="華為未來二十年",
    content_paragraphs=[
        "中國作為世界第二大經濟體...",
        "從經濟總量來看...",
        "未來二十年，隨著科技創新..."
    ],
    output_path=r"E:\Desktop\華為未來二十年.docx"
)

⚠️ 注意事項

1. 必須安裝Microsoft Word（Office套件）
2. 使用專用Python環境: D:\openclaw_project\venv\Scripts\python.exe
3. 路徑使用raw string: 避免轉義問題
4. 檔案佔用釋放: Word COM必須呼叫Quit()釋放檔案

🔄 版本歷史

• v1.0 (2026-03-30): 初始版本，包含完整防禦性程式碼
• v1.1 (2026-03-30): 新增樣式配置分離，函式封裝

這個Skill質量較好，能穩定生成帶格式的Word文件，對編碼和排版問題的處理比較完善。但它只能在Windows系統上使用，還必須安裝Microsoft Office軟體，對於Mac或Linux使用者無法使用。生成的文件樣式較為基礎，缺乏高階排版功能。如果你經常需要在Windows上批次生成正式文件，這個工具值得使用；但如果需要更復雜的排版效果或跨平臺使用，目前還無法滿足需求。