dbskill

name dbskill description 为 Agent 提供统一的数据库访问能力，支持 Direct 直连与 API 模式、多库与审计。在需要查库表结构、执行只读查询或写操作时使用。 DBSkill Skill 为 Agent 提供统一的数据库访问能力，支持： Direct 模式：脚本直连数据库； API 模式：通过 Web 服务 API 访问数据库； 多数据库、多权限级别与审计日志。 目录结构 dbskill/ ├── SKILL.md ├── scripts/ │ ├── schema.py │ ├── query.py │ └── execute.py └── config.example.yaml 配置示例 在项目根或 dbskill/ 目录下创建 config.yaml 。每个 databases.<别名> 必须配置 mode ： direct 或 api 。示例： databases: main: mode: direct type: postgres host: localhost port: 5432 user: postgres password: example database: mydb permission: readonly default_db: main audit: enabled: true log_dir: ./logs/audit retention_days: 30 Direct / API 双模式示例见 dbskill/config.example.yaml 。 Direct 模式调用示例 from dbskill.scripts.schema import get_schema from dbskill.scripts.query import run_query from dbskill.scripts.execute import run_execute # 读取主库的表结构 schema = get_schema(table= "users" , db_alias= "main" ) # 只读查询（内部强制只允许 SELECT/CTE） rows = run_query( sql= "SELECT id, name FROM users WHERE status = :status" , params={ "status" : "active" }, db_alias= "main" , ) # 写操作（仅 permission 为 write/full 时允许） affected = run_execute( sql= "UPDATE users SET name = :name WHERE id = :id" , params={ "name" : "new-name" , "id" : 1 }, db_alias= "main" , ) API 模式（概览） 当 config.yaml 中某个数据库配置为 mode: api 并填写 api_url 、 api_token 时，Skill 将通过 HTTP 调用 Web 服务执行 schema / query / execute 。示例见 dbskill/config.example.yaml 中的 analytics 库。