SuperAPI AI 工具集

python-database

编程与开发

查看项目

更新于 10-24 02:39

技能介绍

Python Database 是一套面向 Python 数据库访问的智能体技能规则集,用于在编写或修改数据库相关代码时提供一致的工程规范。资料给出的优先级为 P1(高)。

用途:规范 Python 应用中的 SQL 查询编写、连接管理、事务控制与存储层抽象,降低 SQL 注入、事务不一致和连接泄漏等风险。

主要能力与规则:

  1. 参数化查询:每条查询都必须参数化,禁止把用户数据或运行时数据插入 SQL 字符串。
  2. 连接与事务的显式归属:连接和事务的所有权必须清晰,通过一个辅助函数或连接池抽象打开连接,并用上下文管理器控制连接与事务的生命周期。
  3. 事务边界:一个业务动作应放在一个事务内,避免事务在处理器、服务与仓储之间被拆分。
  4. 仓储与查询辅助:当业务逻辑依赖存储形态时,应把存储结构隐藏在仓储或查询辅助函数之后。
  5. 持久化边界处理:在持久化边界统一规范化 JSON 与 null 的处理,返回带类型的行或规范化字典,而不是到处泄漏原始游标元组。
  6. 测试提示:在修改 JSON 负载时,应测试格式错误和 null 元数据的路径。

使用方式:资料以规则与配方(Recipe)形式组织,可作为编码或代码审查时的检查清单使用。资料未提供安装命令、代码示例或集成方式。

适用场景:编辑 Postgres 查询、编写 Python 数据访问层、审查数据库相关代码、设计仓储层与事务边界时参考。

反模式:禁止 f-string 拼接 SQL;禁止在处理器、服务与仓储之间拆分事务;禁止在循环中无限制地建立连接;禁止用报表格式化代码掩盖数据库真实状态。

限制:资料仅列出规则与参考方向(框架映射、数据库边界),未说明适用的具体框架、数据库驱动、版本要求、收费方式或平台支持,这些信息暂未提供。