数据库 CRUD 脚本

要解决什么问题

在 Agent 或本地自动化流程里，你往往只需要跑一条 SQL、核对表结构，或在同一事务里完成插入与更新，而不想每次都打开 GUI 客户端或手写一套临时的 Python 连接代码。本技能把 MySQL 的常用 CRUD 收敛到单一入口脚本 run_sql.py，让执行路径固定、可重复。

技能如何工作

• 执行方式：通过 sql 参数直接传语句，或用 --file / -f 读 SQL 文件；--transaction / -t 可把多条语句放在同一事务里提交或回滚。
• 环境与配置：默认读 ~/.config/crud/config.json；可用 AGENT_MYSQL_CONFIG 或 --config 覆盖。首次无配置时会走交互向导，也可显式 --init。
• 输出与控制：--max-rows 限制返回行数，--json 便于下游解析；--env 切换已配置的数据库环境。
• 容错：缺少 pymysql 时会尝试自动安装；连接失败、语法错误会给出可操作提示（如 1045 密码、1049 库名、2003 服务、1146 表名），语法错误场景下会回滚事务。

适用边界与注意点

技能面向 MySQL 直连场景，不负责 ORM 或跨库迁移。拼接动态 SQL 时仍须自行做转义或参数化，不要在代码里硬编码密码；生产环境查询建议只读账号，写操作优先开事务。表结构查看等能力以脚本实际支持为准，复杂运维（备份、权限模型设计）仍需专业工具配合。