zrt-ai-lab/opencode-skills73 installs
smart-query
智能数据库查询技能。通过SSH隧道连接线上数据库,支持自然语言转SQL、执行查询、表结构探索。当用户需要查询数据库、问数据、看表结构时使用此技能。
How do I install this agent skill?
npx skills add https://github.com/zrt-ai-lab/opencode-skills --skill smart-queryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill enables an AI agent to interact with databases via SSH tunnels. Security considerations include the storage of credentials in a plain-text configuration file and the direct execution of raw SQL commands, which could be misused if the agent generates unintended queries.
- Socketwarn
1 alert: gptSecurity
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
7/7 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Smart Query - 智能问数
通过 SSH 隧道安全连接线上数据库,支持自然语言查询和 SQL 执行。
触发场景
- 用户问"查一下xxx数据"、"帮我看看xxx表"
- 用户需要查询线上数据库
- 用户问"有哪些表"、"表结构是什么"
快速使用
1. 测试连接
python .opencode/skills/smart-query/scripts/db_connector.py
2. 执行SQL查询
python .opencode/skills/smart-query/scripts/query.py "SELECT * FROM table_name LIMIT 10"
python .opencode/skills/smart-query/scripts/query.py "SHOW TABLES"
python .opencode/skills/smart-query/scripts/query.py "DESC table_name"
参数:
-n 50:限制返回行数-f json:JSON格式输出--raw:输出原始结果(含元信息)
3. 生成表结构文档
python .opencode/skills/smart-query/scripts/schema_loader.py
生成 references/schema.md,包含所有表结构信息。
自然语言查询流程
- 理解用户意图:分析用户想查什么数据
- 查阅表结构:读取
references/schema.md了解表结构 - 生成SQL:根据表结构编写正确的SQL
- 执行查询:使用
query.py执行 - 解读结果:用通俗语言解释查询结果
配置说明
配置文件:config/settings.json
{
"ssh": {
"host": "SSH跳板机地址",
"port": 22,
"username": "用户名",
"password": "密码",
"key_file": null
},
"database": {
"type": "mysql",
"host": "数据库内网地址",
"port": 3306,
"database": "库名",
"username": "数据库用户",
"password": "数据库密码"
}
}
分享给同事
- 复制整个
smart-query/目录 - 同事复制
config/settings.json.example为settings.json - 填入自己的 SSH 和数据库连接信息
- 安装依赖:
pip install paramiko sshtunnel pymysql
安全提示
config/settings.json包含敏感信息,不要提交到 Git- 建议将
config/settings.json加入.gitignore - 只执行 SELECT 查询,避免 UPDATE/DELETE 操作
依赖安装
pip install paramiko sshtunnel pymysql
脚本清单
| 脚本 | 用途 |
|---|---|
scripts/db_connector.py | SSH隧道+数据库连接,可单独运行测试连接 |
scripts/query.py | 执行SQL查询,支持表格/JSON输出 |
scripts/schema_loader.py | 加载表结构,生成 schema.md |
参考文档
| 文档 | 说明 |
|---|---|
references/schema.md | 数据库表结构(运行 schema_loader.py 生成) |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/zrt-ai-lab/opencode-skills/smart-query">View smart-query on skillZs</a>