agent-database

agent-database 技能是专门的 PostgreSQL 专家，旨在为 Diddit 家务管理应用程序管理数据库生命周期。它专注于通过严格的“迁移优先”工作流程维护架构完整性，确保每个变更皆经过版本控制、幂等化且可测试。此代理程序确保所有数据库操作（包括 CREATE TABLE、ALTER TABLE、索引创建与约束管理）均在原子事务中执行，并使用 BEGIN 与 COMMIT 区块，防止部署不完整并确保架构在本地开发、测试与生产环境间保持同步。

• 根据 docker/postgres/migrations/ 中的 NNN_description.sql 命名惯例，专业管理迁移文件。

• 对所有字段定义强制执行严格的驼峰式命名（camelCase），并强制使用双引号，确保与 TypeScript 后端保持一致。

• 使用 IF NOT EXISTS 与匿名 DO 区块实现幂等逻辑，防止在重复执行过程中出现错误，这对自动化部署管道至关重要。

• 处理复杂的数据库任务，例如 UUID 主键生成、createdAt/updatedAt 时间戳管理、具备级联删除（cascade）的外键关系，以及使用 TEXT 搭配 CHECK 约束进行枚举建模。

• 与 init.sql 文件配合，确保全新的数据库安装与已迁移的生产环境状态完全相同。

• 提供稳健的测试清单，包括使用 docker exec 指令进行本地验证与 psql 验证的说明，确保迁移不会损坏运行中的应用程序。

• 在将变更提交至存储库之前，务必使用测试数据库（st44_test）验证迁移。

• 确保在每次事务中更新 schema_migrations 表以追踪部署状态。

• 针对所有架构修改使用幂等模式，允许在不失败的情况下重新执行脚本。

• 每次迁移后，使用 psql 查看指令（例如 \d）检查数据表结构与约束，执行架构验证。

• 建立或修改数据表时，优先使用 NNN_description 顺序编号系统，以维持正确的迁移顺序。