用途：通过 SSH 隧道安全连接线上数据库，把自然语言问题转成 SQL 并执行，同时可探索表结构。触发场景包括用户想查某类数据、需要查询线上数据库，或询问有哪些表、表结构是什么。
主要能力：db_connector.py 用于建立 SSH 隧道加数据库连接并测试连通性；query.py 执行 SQL，支持表格与 JSON 输出；schema_loader.py 加载表结构并生成 references/schema.md。自然语言查询流程为：理解意图、查阅 schema.md、生成 SQL、用 query.py 执行、用通俗语言解读结果。
使用方式：测试连接执行 python .opencode/skills/smart-query/scripts/db_connector.py；查询示例 python .opencode/skills/smart-query/scripts/query.py "SHOW TABLES"，参数有 -n 50 限制行数、-f json 输出 JSON、--raw 输出含元信息的原始结果；生成表结构文档执行 python .opencode/skills/smart-query/scripts/schema_loader.py 生成 references/schema.md。安装依赖 pip install paramiko sshtunnel pymysql。配置在 config/settings.json，含 SSH（host、port、username、password、key_file）与 database（type、host、port、database、username、password）两部分。分享给同事可复制整个 smart-query/ 目录，复制 settings.json.example 为 settings.json 并填入自己的连接信息。
限制与安全：settings.json 含敏感信息，不要提交到 Git，建议加入 .gitignore；建议只执行 SELECT 查询，避免 UPDATE/DELETE。是否支持其他数据库类型、具体性能与限制暂未提供。