MySQL 连接与查询

MySQL 连接与查询

何时使用

• 用户要求查询 MySQL、查询数据库里一共有哪些表、查看某张表数据、统计条数、检查表结构
• 必须由用户提供连接信息（host、port、user、password、database），不得从环境变量或 application.yml 读取

连接信息：必须由用户提供

• 禁止从 application.yml、application-*.yml、环境变量、.env 等读取 MySQL 连接信息。
• 调用脚本或写代码时，必须使用用户本次提供的：host、port、user、password、database。
• 若用户未提供完整连接信息，应提示用户补全后再执行。

执行合同

适用前提

• 任务目标是只读查询、验数、查结构或排障取数，而不是写库或迁移。
• 用户已经在本次对话中提供了完整连接信息；若未提供完整信息，本 skill 只能停在待补充状态。

任务变量

• host、port、user、password、database：全部必须来自用户当次提供。
• sql：本次准备执行的只读 SQL。
• <skill_dir>：当前安装环境中的 mysql-query 技能目录，用于定位脚本。

变量来源

• 所有连接变量只能来自用户消息、当前任务单或上游 /handoff 中明确给出的数据库连接信息。
• 不允许从仓库配置、环境变量、历史默认值或示例命令中推断真实密码。
• <skill_dir> 为当前 skill 安装目录，由运行环境解析，不需要用户提供。
• 若 SQL 语义不明确，应先把查询目标写清楚再执行，避免误查大表。

执行入口

1. 先确认 SQL 是只读语句，并按需补 LIMIT。
2. 优先使用当前 skill 的脚本执行，除非用户明确要求别的方式。
3. 若连接信息不完整或只读边界不清晰，先停在 待确认项，不要私自补全。
4. 不把密码写入仓库、脚本文件或长期日志。