前言¶
让 Coding Agent 写 SQL 或排查数据问题时，常见做法是临时拼连接串、在对话里贴查询结果，或让模型「猜」表结构。多库并存时（MySQL 与 PostgreSQL 混用、本地 SQLite 与线上库对照），连接方式、参数绑定和事务边界很容易不一致，也不利于复用。
下面介绍 SkillHub 上的 database_skill：用 Python 封装多类关系型数据库的连通能力，把连接管理、参数化查询、库表元数据查看和事务交给 Skill 约定好的流程，供 Agent 按 SKILL.md 执行。本文事实来自 SkillHub 页面与安装说明文档，未在公开页出现的用法不展开。
这是什么¶
database_skill（坐标 @user_e71390e8/dbskill，当前版本 1.0.0）是一条面向开发的 Agent Skill，分类为 dev-programming，来源标注为 community，由发布者 user_e71390e8（SkillHub 页面作者显示为褚嬴）提供。
一句话定位：基于 Python 3.8+ 的数据库连通 Skill，支持 MySQL、PostgreSQL、Oracle、SQL Server、SQLite，并提供连接管理、参数化查询执行、schema 自省（schema introspection）与事务管理。页面标签 requires_api_key=false，表示 SkillHub 侧未要求额外 API Key 才能安装该技能本身（具体数据库仍须你自备账号与网络可达性）。
Skill 资源入口：
- API / 资源地址：
https://api.skillhub.cn/user_e71390e8/dbskill - SkillHub 展示页：
https://www.skillhub.cn/skills/user_e71390e8/dbskill
核心功能¶
以下能力均来自官方简介，未单独核实的接口名与脚本不在此列举。
- 连接管理：在同一套 Skill 约定下处理多种数据库类型的连接建立与维护，减少 Agent 为每种库各写一套临时代码。
- 参数化查询执行：强调 parameterized query，有利于降低拼接 SQL 带来的注入与转义错误（具体驱动与占位符语法以 Skill 内 Python 实现为准）。
- Schema 自省：支持查看库表结构类信息，便于 Agent 在写查询前对齐真实字段，而不是依赖过时文档。
- 事务管理：在需要多步写入或回滚的场景下，由 Skill 侧提供事务相关能力，避免对话里「半成功」的状态。
运行环境要求：Python 3.8+。各数据库对应的客户端库、连接串格式需在本地或部署环境中自行满足；Oracle、SQL Server 等往往比 SQLite 多一层驱动与权限配置，使用前应在目标环境先验证连通性。
安装与启用¶
SkillHub 官方给出的安装提示是：让 AI 参照安装文档，安装坐标 @user_e71390e8/dbskill。文档地址为 https://skillhub.cn/install/skillhub.md。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、把 Skill 装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。文档记载的常见路径如下（按你使用的客户端择一）：
| 客户端 | skills 目录（文档记载） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中安装本 Skill 的示例（将目录换成你环境真实路径）：
skillhub install @user_e71390e8/dbskill --dir ~/.cursor/skills/
也可在对话中直接发送 SkillHub 页面提供的提示词，让 Agent 按 skillhub.md 完成安装与目录校验。
3、启用与重启¶
经过上面的步骤，Skill 会落在对应 skills 目录下的标准 SKILL.md 结构中。若客户端在安装前已启动，按各客户端惯例可能需要重启或刷新技能列表后，Agent 才会加载 database_skill。公开页面未给出 Codex CLI 与 Claude Code 的差异化配置项，除 skills 路径外不做额外假设。
典型用法¶
SkillHub 公开展示页主要提供简介与安装指引，未附带可逐行复制的查询示例或连接配置样例。实际工作流程通常是：
- 完成安装后，在 Agent 中启用该 Skill；
- 用自然语言说明目标库类型、只读或读写需求，以及需要执行的 SQL 或表结构探查任务；
- Agent 依据包内 SKILL.md 与 Python 实现调用连接管理、参数化执行、schema 自省或事务相关步骤。
若你需要可复现的命令级示例，应在安装后打开本地 SKILL.md 及同目录脚本核对；本文不编造未出现在官方资料中的连接字段名或示例 SQL。
适用场景与注意¶
适合谁
- 经常在 Agent 会话里查库、对表结构、或做小范围数据修正的开发者；
- 团队同时使用多种关系型数据库，希望 Agent 侧有一套统一的 Skill 约定，而不是每次手写
psycopg2/pymysql片段。
使用注意
- 权限与安全：Skill 能执行查询与事务时，应使用权限最小化的数据库账号，生产库优先只读；勿在对话中粘贴长期有效的生产密码。
- 驱动与环境：Python 3.8+ 是 Skill 声明的底线；Oracle、SQL Server 等还需本机或运行环境安装对应驱动，并与防火墙、VPN 策略一致。
- 社区来源：来源为 community，升级与维护节奏取决于发布者；重大版本变更前可在 SkillHub 查看 v1.0.0 及后续版本说明。
- 平台数据：SkillHub 页面展示的评分为 100000，下载 3975（统计以页面为准，会随时间变化）；安装计数在抓取时为 0，仅作参考，不代表功能不可用。
结尾¶
database_skill 把多库连通、参数化查询、schema 查看和事务管理收敛到一条 Python Skill，适合希望 Agent 按统一流程操作关系型数据库的场景。安装时记住坐标 @user_e71390e8/dbskill，并用 --dir 对准当前客户端的 skills 目录。
官方展示与资源：
https://www.skillhub.cn/skills/user_e71390e8/dbskillhttps://api.skillhub.cn/user_e71390e8/dbskill
