database-migrations
作者 affaan-mdatabase-migrations 技能帮助后端团队为 PostgreSQL、MySQL 以及常见 ORM 规划安全的架构变更、数据回填、回滚和零停机发布。适合需要清晰步骤、更少锁表、并且支持可逆变更的生产环境数据库迁移指南工作。
该技能得分 78/100，说明它值得在 Agent Skills Finder 中列出：它为 agent 提供了清晰的迁移工作流和足够的操作指导，相比通用提示能减少猜测，但由于缺少配套脚本或参考文件，用户仍需接受一定局限。
- 针对迁移任务的触发意图很明确，涵盖架构变更、数据回填、回滚和零停机规划。
- 工作流内容较充实，包含安全原则和清单式指引，有助于 agent 更稳定地执行。
- 覆盖多个常见技术栈和 ORM（PostgreSQL、MySQL、Prisma、Drizzle、Kysely、Django、TypeORM、golang-migrate），便于跨项目复用。
- 未找到安装命令、脚本、参考资料或配套文件，因此落地主要依赖书面的 SKILL.md。
- 仓库证据显示有较强的指导文本，但可执行脚手架有限，因此 agent 在面向具体工具实现时仍可能需要人工解读。
database-migrations 技能概览
database-migrations 是做什么的
database-migrations 技能帮助你为后端系统规划并编写安全的数据库变更。它最适合用在你需要发布 schema 更新、回填、回滚，或零停机变更，而且又不想靠猜操作顺序的时候。
适合谁使用
如果你在使用 PostgreSQL、MySQL，或者 Prisma、Drizzle、Kysely、Django、TypeORM、golang-migrate 这类常见迁移框架做后端开发，就可以使用 database-migrations 技能。它尤其适合生产安全比临时快速改动更重要的场景。
它有什么不同
这个 database-migrations 技能对生产环境纪律有明确主张：迁移应该只向前推进，schema 变更和数据变更要分开，且必须用真实规模的数据来测试。相比通用提示词，它更适合你需要更少锁、更清晰回滚路径和更明确部署步骤的情况。
如何使用 database-migrations 技能
安装并启用它
使用以下命令安装 database-migrations 技能：
npx skills add affaan-m/everything-claude-code --skill database-migrations
当你的任务涉及迁移决策时就启用它，而不是等 schema 已经出问题之后再说。最适合使用 database-migrations install 这种思路的时机，是你还在写 SQL、生成 ORM migration，或者规划部署顺序之前。
给技能提供正确输入
想让 database-migrations usage 发挥效果，请提供：
- 数据库引擎和版本
- 表规模，以及这张表是否是热点表
- 你想要的准确 schema 变更
- 这次变更是否必须零停机
- 是否需要回滚支持
- 当前使用的 ORM 或迁移工具
较弱的提问是：“让这个迁移安全一点。”
更好的提问是：“我需要在一个 4000 万行的 PostgreSQL 表里新增一个可空的 status 列，这个表被一个 Web 应用使用，而且没有维护窗口。请给我最安全的迁移步骤和回滚方案。”
先阅读正确的文件
先看 SKILL.md，然后再检查仓库里的配套说明，比如 README.md、AGENTS.md、metadata.json，以及如果存在的话，rules/、resources/、references/ 或 scripts/ 这些目录。对于这个仓库来说，SKILL.md 是主要事实来源，所以在适配到你的技术栈之前，先从里面提取清单、启用触发条件和数据库特定模式。
采用以迁移为先的工作流
一个实用的 database-migrations guide 通常按这个顺序进行：
- 定义期望的最终状态
- 把 schema 变更和数据回填分开
- 判断操作是否可以在线执行
- 编写前向步骤和回滚步骤
- 在接近生产的数据上测试
- 如有需要，分阶段发布
这个工作流很重要，因为这个技能的目标就是降低锁风险、避免破坏性回滚，并减少“测试环境没问题，线上却出错”的意外。
database-migrations 技能 FAQ
database-migrations 只适用于 PostgreSQL 吗？
不是。database-migrations 技能覆盖 PostgreSQL 和 MySQL，也适用于围绕常见 ORM 和迁移工具构建的工作流。不同引擎对应的 SQL 模式会变化，但安全模型是一样的。
它比普通提示词更好吗？
是的，前提是这项工作真的会影响生产环境。普通提示词可能只会给你一个迁移形态建议，而 database-migrations 技能会在锁、可逆性，以及 schema 和数据变更分离这几件事上提供更强的护栏。
新手可以用吗？
可以，只要他们能把变更描述清楚。新手在明确表、数据量和可接受停机时间时，能获得最大价值，而不是只问一个通用的迁移模板。
什么时候不应该用它？
不要把它当成应用特定校验或数据库引擎文档的替代品。如果你的任务只是一个没有生产数据的本地一次性原型，那么这个技能可能比你实际需要的流程还要重。
如何改进 database-migrations 技能
先把部署约束说明白
当你明确说明应用是否能承受锁、部署是 blue-green 还是 rolling、以及变更期间写入是否仍会继续时，database-migrations usage 的质量会明显提升。这些约束决定了迁移能否在线完成，还是必须拆成多个阶段。
补充数据量和风险细节
如果你提到行数、索引大小、外键，以及这张表是否写入频繁，这个技能会更有用。这些信息能帮助避免常见失败模式，比如在没有默认值的情况下添加 NOT NULL、内联构建索引，或者把数据回填和 schema 变更混在一起。
直接要一份具体迁移方案
不要只问“最佳实践”，而要明确你想要的方案：SQL、回滚路径、校验检查，以及部署顺序。如果第一次输出太泛，就补充你当前的 schema、目标 schema，以及来自 Prisma、Drizzle、Kysely、Django、TypeORM 或 golang-migrate 的任何 ORM 限制，再继续迭代。
把第一次输出当作草稿
先用第一版结果确认安全假设，再针对真实环境细化。最有效的改进通常来自更严格地定义数据形态、标明不可逆部分，并要求 database-migrations skill 在安全性、速度或最小锁影响之间做优化，而不是三者同时兼顾。