用途:在数据库迁移命令执行后自动重新生成数据库结构映射文件 DBMAP.md,避免手工维护。
主要能力:通过 PostToolUse 钩子监听 Bash 工具调用,匹配常见迁移命令,覆盖 Rails db:migrate、Django manage.py migrate、Alembic、Prisma、Knex、Sequelize、Goose、Dbmate、Flyway、Liquibase、TypeORM、Drizzle 等框架。
使用方式:先确认要使用的 DSN,可运行 "${REPOMAP_HOME:-$HOME/claude-repomap-command}/scripts/run.sh" dbmap --list 检测连接并让用户确认,或直接由用户提供 DSN;随后写入配置文件:printf '%s\n' '<confirmed_dsn>' > .dbmap-auto;并确保其被 gitignore:touch .gitignore && grep -qxF '.dbmap-auto' .gitignore || printf '\n.dbmap-auto\n' >> .gitignore。
限制与注意:DSN 含凭据,.dbmap-auto 必须加入 .gitignore;使用前 DBMAP.md 必须已存在,否则需先运行 /dbmap;钩子仅在迁移命令实际执行后触发,仅编辑迁移文件不会触发,因为结构尚未变化;删除 .dbmap-auto 或运行 /dbmap-auto-off 可关闭。