用途:为需要数据库功能的项目提供统一的 SQLite 实现规范,强制所有 SQL 语句集中在 database.py,应用代码只调用函数接口,实现 SQL 完全隔离。
主要能力:提供标准接口模式,包括 get_connection、init_db、db_query、db_execute、db_insert;支持在 database.py 中追加领域专用函数,如 get_user_by_id、get_user_by_email、create_user、delete_user;涵盖分页查询与事务处理等常见模式。
使用方式:项目结构为 database.py(存放全部 SQL)、app.py(仅调用数据库函数,不写 SQL)、tests/test_database.py。应用侧导入 init_db、get_user_by_id、create_user 等函数即可完成初始化、创建与查询,无需直接接触 SQL。
安全与限制:必须使用参数化查询(如 SELECT * FROM users WHERE email = ? 配合参数元组),禁止字符串拼接以防 SQL 注入;默认仅使用 SQLite;建议将 .db 文件加入 .gitignore。官方标注该技能对所有需要数据库功能的项目为强制要求。完整模板、迁移模式、测试与性能优化见 AgentUsage/db_usage.md。