pdlc-db-migratelisted

# 数据库迁移管理 <!-- @include templates/prompts/iron-law.md --> 根据 db-design 文档管理数据库迁移脚本，支持生成、执行、回滚和状态查看。 ## 子命令解析 从 `$ARGUMENTS` 中解析子命令和参数： | 子命令 | 格式 | 说明 | |--------|------|------| | `generate <描述>` | 根据 db-design 文档生成版本化迁移脚本（up + down） | | `status` | 查看迁移状态，列出已执行/待执行的迁移 | | `up` | 执行所有待执行的迁移 | | `down [N]` | 回滚最近 N 个迁移（默认 1） | | `diff <功能名>` | 对比 db-design 文档与现有迁移脚本，生成增量迁移 | 如果未提供子命令或子命令无法识别，输出以上帮助信息后停止。 --- ## PDLC 前置检查（仅 generate 和 diff 子命令） 当子命令为 `generate` 或 `diff` 时执行： 1. 从用户输入中提取功能名称关键词 2. 在 `docs/02_design/database/` 目录下搜索包含该关键词的数据库设计文档 - 匹配新格式：`F<日期>-<NN>-*<关键词>*-db.md` - 匹配旧格式：`YYYYMMDD-*<关键词>*-db.md` - 同时检查文件内容中是否包含该关键词 3. **未找到** → 输出以下信息后**立即停止，不继续执行**： ``` ⛔ PDLC 守卫：未找到与「<功能名>」相关的数据库设计文档。 迁移脚本必须基于已有的数据库设计。请先运行： 👉 /pdlc-db-design <设计目标> ``` 4. **找到** → 提取功能ID（如 `F20260326-01`），读取该设计文档内容，继续执行 --- ## 迁移文件约定 ### 目录结构 - 微服务项目：`backend/services/<service>/migrations/` - 单服务项目：`migrations/` - 自动检测：如果存在 `backend/services/` 目录，按微服务项目处理；否则按单服务项目处理 ### 文件命名 - UP 脚本：`V<版本号>__<描述>.sql` - DOWN 脚本（回滚）：`R<版本号>__<描述>.sql` - 版本号格式：`YYYYMMDD_HHMMSS`（如 `20260402_143052`） ### 文件头部注释 每个迁移文件必须包含以下头部注释： ```sql -- ============================================== -- 迁移脚本: V20260402_143052__create_users_table.sql -- 功能ID: F20260402-01 -- 描述: 创建用户表 -- 作者: <从 git config 获取> -- 日期: 2026-04-02 -- ============================================== ``` --- ## 子命令执行流程 ### generate <描述> 1. 执行前置检查，读取 db-design 文档 2. 读取 `.claude/templates/pdlc/db-migrate-templa