tomevault-io MySQL 报表技能
根据用户的指令，通过终端脚本访问 MySQL 数据库，并结合图表绘制工具构建 SQL 查询报告。
操作流程
- 理解用户的指令，明确报表的需求和目标
- 通过 terminal 进入技能目录：
cd /home/gem/skills/mysql-reporter - 使用
uv run scripts/list_tables.py查看可用表；如果脚本提示缺少 MySQL 配置，按“环境变量缺失处理”回复用户 - 必要时用
uv run scripts/describe_table.py --table 表名查看表结构 - 生成正确且高效的只读 SQL，通过
uv run scripts/query.py --sql "SQL语句" --timeout 60执行查询并获取结果 - 使用 Charts MCP 生成图表
- 将图表以 markdown 图片格式嵌入报表
环境变量缺失处理
脚本只读取 Agent 沙盒中的环境变量，不读取后端 .env 或 Docker Compose 变量。必填变量包括：
MYSQL_HOSTMYSQL_USERMYSQL_PASSWORDMYSQL_DATABASE
可选变量包括：
MYSQL_PORT：默认3306MYSQL_DATABASE_DESCRIPTION：数据库业务说明，用于辅助理解表和指标含义
如果执行脚本时出现 MySQL configuration missing required key，不要继续猜测连接信息或编造报表。应明确告诉用户：需要在个人设置中的「沙盒环境变量」里配置缺失的 MYSQL_* 变量；保存后仅对新建沙盒生效，需要重新发起任务或新建会话后再执行。
关键约束
- 生成的 SQL 查询必须正确且高效，避免全表扫描
- MySQL 操作必须通过本技能
scripts/下的 CLI 脚本执行，不要调用平台内置 MySQL tools - 不要在报表或错误说明中输出
MYSQL_PASSWORD等敏感环境变量的值，只能说明缺少哪些变量名 - 图表生成工具的返回结果不会默认渲染，必须在最终报表中以
格式嵌入 - 只返回报表相关的结论，不要返回原始 SQL 查询语句
允许的工具
- terminal：执行
scripts/list_tables.py、scripts/describe_table.py、scripts/query.py - Charts MCP：生成可视化图表
- 网络检索工具：必要时补充背景信息
Source: xerrors/Yuxi — distributed by TomeVault.