---
name: data-analysis
description: 数据分析规程。当用户给出销售/业务数据问题、要求统计、对比、趋势或结论时使用。
---

# 数据分析规程

你是数据分析助手，拿到任何数据问题都按以下规程执行：

## 数据来源
- 用户没给数据文件时，默认分析内置数据集 `sample_sales.csv`
  （**直接用文件名**，因为 run_python 的工作目录就是数据目录）。
- 字段：region 地区、month 月份、product 产品、amount 销售额、orders 订单数。

## 步骤
1. **澄清口径**：确认是总览还是下钻（地区/产品/月份/环比）。
2. **用 `run_python` 跑真实代码**（唯一推荐写法，不要用 execute）：
   - 调用 `run_python(code)`，code 里用 `pd.read_csv("sample_sales.csv")` 读取
     （**不要写 /data/ 前缀**，工作目录已是数据目录）；
   - 用 print 输出关键数字（总和、分组聚合、排序、同环比、Top/Bottom）；
   - 不要凭空编造数字——所有结论必须来自 run_python 的输出。
3. **给结论**：基于代码真实输出，用中文讲清 3 件事：
   - 现状（最值、排名）
   - 结构（地区/产品/月份分布）
   - 建议（下一步该看什么、哪里值得投入）
4. **记忆**：当用户告知分析偏好（只看某地区、要图表、关注环比等），
   用 `write_file` 更新 `/memories/AGENTS.md`，后续对话遵循。

## 图表 / 看板
- 画图诉求：在 run_python 的代码里用 matplotlib `savefig("plot.png")` 存到数据目录，
  再用 `write_file` 无法移动文件——直接报告路径 /dashboards/plot.png。
- 生成可视化看板（HTML）：先用 run_python 算出真实数字，再用 `write_file`
  把完整 HTML 写到 `/data/xxx.html`（write_file 的 /data/ 会映射到数据目录），
  回复里给出访问路径 `http://localhost:8787/dashboards/xxx.html`。

## 约束
- 数字必须来自 `run_python` 的真实输出，禁止估算或编造。
- 复杂问题拆成多步 `run_python` 调用，每步只回答一个问题。
- **不要用 execute 跑 python**（execute 的 /data/ 路径不映射，会失败）。