mysql-connection

Files (3)

• SKILL.md
• connection.yml · assets/
• commands-and-results.md · references/

SKILL.md (first lines)

# MySQL 连接

本技能（Skill）维护 MySQL 接入方法。Buildr 的查询工具是独立内置能力（Builtin），负责数据库展示偏好、表结构浏览和受限只读查询；这些内容不写入连接声明或连接配置。变更动作只经本技能的程序执行，查询工具不因此获得写入能力。

先从用户目标、服务配置与已登记连接找到准确主机、端口、环境和数据库。执行 `buildr connection-skill --help`，再读取 `definitions list --json` 与 `list --json`；核对所选实例明确绑定 `mysql-connection` 的 `mysql` 定义，不按系统名称、类别或同名旧实例推断绑定。新建和认证录入使用当前管理入口及其已观察版本，不按同名接管实例，不自动搬运个人密码。

团队认证与个人认证均为包含用户名、密码的完整认证组（Authentication Group）；个人组存在但失效时停止，不回退团队组。目标主机、端口、账号或程序接收方变化后重新配置完整认证。允许明确的空密码；不得把用户名保留为共享配置、只覆盖个人密码。

程序 `buildr-mysql` 随 Buildr 主包安装，以独立进程间通信（IPC）接收本次明确选中的连接上下文；认证不进入参数、普通环境或业务标准输入（Standard Input）。先执行通用 `check` 与 `help` 核对当前程序和版本；缺失时按声明的安装指引恢复，不绕过绑定调用其他程序。帮助与版本检查离线运行。具体命令及结果见 [命令与结果](references/commands-and-results.md)。

只读测试执行受限版本查询，数据库发现只读取当前账号可见范围。它们不修改数据库或连接配置，也不证明用户业务目标完成。用户查询通过独立查询工具进行，并明确选择本次实例版本和数据库；查询工具保留每个实例独立的本机偏好（Preference）。测试失败时区分网络、认证、权限和版本问题，不打印远端认证回显，不自动更换认证或实例重试。

使用真实工作空间（Workspace）验收时，仅在用户授权的实例、环境和数据范围内执行。只读验证不能替代结构变更、数据修改或业务效果验证。

## 受控变更

连接被标记为生产环境时拒绝变更，由人工执行并另行核验；未声明环境时按非生产执行，并在结果中标注没有生产保护。若该连接实际指向生产，应在连接配置中标注 `prod`。删除表与清空表默认拒绝，仅当连接配置开启「允许破坏性语句」且环境非生产时执行；权限与账号、服务器全局状态、过程/触发器/事件及文件导入导出类语句不在变更范围，不受该开关影响。

一次 `apply` 只执行一条语句，并按类别分别报告：数据修改在事务内执行，必须带 `WHERE` 并显式提供受影响行数上限，超过上限即回滚且不保留部分修改；结构变更已执行且不可回滚，只回读当前结构。执行前先读取目标表结构摘要（`fingerprint`），向用户展示目标环境、表、语句与预期影响，再以同一摘要提交；结构已变化时拒绝执行。

超时、连接中断或外层终止时结果未知：重新读取实际结构与数据后再判断，不自动重试，也不把未知表述为失败或完成。变更结果只证明该次语句与回读一致，不证明业务目标完成。

From BuildrAI/Buildr, MIT.

More from BuildrAI/Buildr