Adb mysql

即插即用的 AI Agent 技能集合 — 飞书集成 · Mermaid 图表 · Codex 编排 · 前端设计规格

Install

npx -y skills add northseadl/norix-skills --skill adb-mysql

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

'阿里云 AnalyticDB (ADB) for MySQL 只读数据分析。

SKILL.md

3.1 KB, as published. Nobody here has run it

ADB 数据分析技能

安装

pip install pymysql

仅依赖 pymysql（纯 Python MySQL 驱动），无需本地 mysql 客户端。

配置

添加连接

./adb config add <profile-name> \
  --host <DMS代理地址或ADB实例地址> \
  --user <AccessID或用户名> \
  --password <AccessSecret或密码> \
  --database <数据库名> \
  --test

凭据存储在 ~/.adb-mysql/profiles.json（权限 0600），支持多 Profile。

管理连接

./adb config list                    # 列出所有 profile
./adb config use <profile-name>      # 切换默认 profile
./adb config test [profile-name]     # 测试连接
./adb config remove <profile-name>   # 删除 profile

脚本

query — SQL 查询（只读）

./adb query "SELECT * FROM users LIMIT 10"
./adb query -d mydb "SELECT COUNT(*) FROM orders"
./adb query -f report.sql --format csv
./adb query -p staging "SELECT 1"          # 指定 profile

选项：-p profile / -d 数据库 / -f SQL 文件 / --format table|csv|json

analyze — 数据分析（带交叉验证）

./adb analyze -t orders -c                                    # 计数分析
./adb analyze -t orders -g status -a "SUM(amount)"            # 聚合分析
./adb analyze -t orders --time-col created_at \
  --start-date 2024-01-01 --end-date 2024-02-01               # 时间序列

每次分析自动执行交叉验证：总行数 → 随机样本 → 数值统计 → 时间范围。

schema — Schema 文档生成

./adb schema mydb                    # 生成到 ~/.adb-mysql/schema/mydb/
./adb schema mydb -o ./docs/schema   # 自定义输出目录

为所有表生成 Markdown 文档（字段定义、索引、ADB 分布键、查询示例）+ 索引文件。

Agent 工作流: 首次分析某数据库前，先运行 ./adb schema 生成文档到 ~/.adb-mysql/schema/，后续分析时读取作为上下文。

安全策略

只读: 正则拦截 INSERT / UPDATE / DELETE / DROP / CREATE / ALTER / TRUNCATE 等写入操作
行数限制: 自动添加 LIMIT 200，超出自动截断
性能警告: 检测 SELECT * / 缺少 WHERE / JOIN 无 ON 条件
凭据安全: 配置文件权限 0600，密码不出现在命令行参数

模块架构

adb (Bash CLI 入口)
│
├── config   → config.py    多 Profile 连接管理 (add/list/use/test/remove)
├── query    → query.py     SQL 只读查询 (table/csv/json 输出)
├── analyze  → analyze.py   多维分析 + 交叉验证
└── schema   → schema.py    Schema 文档生成 (Markdown)
               ↓
            adb_core.py      核心引擎 (pymysql 连接 + SQL 安全 + 输出格式化)
               ↓
         ~/.adb-mysql/
           ├── profiles.json  连接配置
           └── schema/        Schema 文档输出