---
name: create-migration
description: 将带日期标注的 SQL 迁移脚本追加到 updatesql/sql.md
---

# SQL 迁移脚本添加技能

将数据库变更写入 `updatesql/sql.md`，遵循项目的数据库变更管理规范。

## 输入参数

用户需提供：
- **SQL 语句**: 如 `ALTER TABLE pos_order ADD COLUMN delivery_status BIGINT DEFAULT NULL`
- **用途描述**: 如 "订单状态四字段分离"

## 执行步骤

### 第1步：生成注释头
- 获取当前日期，格式 `YYYY-MM-DD`
- 生成注释行：`-- YYYY-MM-DD <用途描述>`

### 第2步：追加到 sql.md
- 读取 `updatesql/sql.md` 当前内容
- 在文件末尾追加注释头 + SQL 语句 + 空行
- **绝不直接执行 SQL**，只写入文件

### 第3步：验证
- 确认 SQL 语法基本正确（以 ALTER/CREATE/UPDATE/INSERT/DELETE 开头）
- 确认注释头格式正确
- 确认文件已成功写入

## 注意事项

- SQL 语句末尾必须有分号
- 每条迁移之间保留空行分隔
- 不要修改已有的迁移记录
