name: office-generator-py description: Generate Office files with a bundled Python engine. Use when creating or exporting Word (.docx), Excel (.xlsx), or PowerPoint (.pptx) files from structured JSON, reports, meeting minutes, project plans, trackers, business briefs, or natural-language requirements that must be turned into Office documents.

Office Generator Py

Generate Office files with the bundled engine under scripts/engine/.

First run

Install Python dependencies into the bundled virtualenv:

python3 skills/office-generator-py/scripts/setup_engine.py

If you manage the environment yourself, you can point the wrapper at another Python binary with OFFICE_GENERATOR_PYTHON=/path/to/python.

Quick workflow

1. Decide the output type: docx, xlsx, or pptx.
2. Prefer a built-in business template when it fits.
3. Write a UTF-8 JSON request file.
4. Run scripts/generate_office.py.
5. Return the produced file path.

Entrypoints

Use scripts/generate_office.py.

• Standard mode: pass --type with a full JSON request file.
• Business mode: pass --kind, --title, --input, and --out.

Built-in templates

Word

• word_work_report_v1
• meeting_minutes_v1

  訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

Excel

• excel_data_tracker_v1
• project_plan_v1

PPT

• ppt_business_brief_v1
• project_status_brief_v1

Built-in business kinds

• word-report
• meeting-minutes
• excel-tracker
• project-plan
• ppt-brief
• project-status-brief

Commands

Standard mode:

python3 skills/office-generator-py/scripts/generate_office.py \
  --type docx \
  --input /absolute/path/request.json \
  --out /absolute/path/output.docx

Business mode:

python3 skills/office-generator-py/scripts/generate_office.py \
  --kind meeting-minutes \
  --title "Office 評審會紀要" \
  --purpose "內部存檔" \
  --input /absolute/path/content.json \
  --out /absolute/path/meeting_minutes.docx

Request shaping

If the user gives natural language only, convert it into JSON first.

For supported request formats and sample payloads, read references/input-formats.md.

Output contract

• Success: stdout prints the generated file path.
• Failure: stderr prints the error; command exits non-zero.

Notes

• Keep output paths absolute when possible.
• Prefer business mode for common document types.
• Use standard mode when the caller already has full documentType/templateId/contentSpec JSON.

質量中規中矩，能正常生成 Word、Excel、PPT 三種檔案。優點是操作簡單、有現成模板可用、錯誤提示清晰；缺點是模板數量少、文件說明不夠詳細、缺少示例檔案參考。對於日常簡單文件需求基本夠用，但複雜場景可能需要自行調整配置。整體屬於可用但不夠完善的工具。