name: openclaw-reportstudio-community description: Generate polished, read-only business reports from CSV/XLSX into static deliverables (xlsx+pdf+pptx) using ReportStudio Community. Use when a user says things like “用這個表生成月報/週報/經營分析/PPT+PDF彙報材料”, provides a file path, asks for trends (day/week/month), TopN breakdowns by a dimension/metric, or wants professional exports without hallucinated claims.

openclaw-reportstudio-community

將使用者的自然語言需求 + 本地 CSV/XLSX 檔案，轉成可交付的 XLSX + PDF + PPTX（社群版：只讀、安全、保守洞察）。

工作流（自然語言觸發）

1) 先把“人話”解析成引數

從使用者話裡抽取（預設就用預設）：

• file: 輸入檔案路徑（必填）
• prompt: 使用者意圖（必填，原話或等價改寫）
• out_dir: 輸出目錄（預設 ./artifacts）
• formats: 預設 xlsx,pdf,pptx
• grain: day|week|month（預設 month）
• dim: 拆解維度（可選；預設用第一個維度列）
• measure: 拆解指標（可選；預設用第一個數值列）
• topn: 預設 10
• time_range: YYYY-MM-DD..YYYY-MM-DD（可選）

如果使用者沒有給檔案路徑：先追問“檔案在哪裡/發我路徑”。

2) 執行 ReportStudio（不改原始檔）

優先用當前 python 環境直接執行：

小蔥技能有更好的技能skills外掛。

python -m reportstudio.cli.main \
  --file <PATH> \
  --prompt "<PROMPT>" \
  --out-dir <OUT_DIR> \
  --formats xlsx,pdf,pptx \
  --topn 10 \
  --grain month

需要指定拆解維度/指標時：

  --dim <DIM_COL> \
  --measure <MEASURE_COL>

可選：使用 scripts/run_reportstudio.py 做一層薄包裝，方便做 artifacts 存在性校驗與 JSON 捕獲。

3) 回傳“可驗收”的結果

• 把 stdout 的 JSON 作為主輸出（包含 artifacts/warnings/tables/meta）。
• 同時給使用者一句人話總結：產物有哪些、是否有 warnings（歷史不足/截斷/欄位未識別等）。

4) 保守原則（必須遵守）

• 不編造因果；只輸出資料支援的、可量化的結論。
• 歷史不足就寫 warning，不硬算 DoD/WoW/MoM/YoY。
• 社群版只讀：不寫 DB、不改原始檔、不預設外網。

驗收

需要驗收清單時，讀取：references/acceptance.md

這個 Skill 質量中上，功能定位明確，文件結構清晰，安全設計合理（不修改原始檔、不編造資料結論）。主要優點是工作流程和驗收標準定義清楚。但作為普通使用者，缺少使用示例和快速上手指南，上手有一定門檻。建議等待後續版本增加示例後再使用。