Exécutez n'importe quel Skill dans Manus
en un clic

Exécutez n'importe quel Skill dans Manus en un clic

Commencer

dev-schema-upgrade-sql

Étoiles209

Forks5

Mis à jour19 mai 2026 à 16:24

MallBase 数据库变更同时维护 schema 真相源与 git-ignored 幂等增量升级 SQL；新增/修改表、字段、初始数据时使用。

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

yyw-code

yyw-code/MallBase

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Métiers associésSOC

Basé sur la classification professionnelle SOC

Architectes de bases de donnéesProfessions informatiques et mathématiques·SOC 15-1243

SKILL.md

readonly

name	dev-schema-upgrade-sql
description	MallBase schema 真相源与幂等升级 SQL 规则；升级 SQL 仅在用户明确要求已有库升级时使用。

Skill: dev-schema-upgrade-sql

适用场景

在 deploy/install/data/schema/*.sql 增加/修改字段、表、初始数据
在 deploy/install/data/demo/*.sql 增加/修改演示数据
任何 mb_setting / mb_goods / mb_user 等表的 seed 调整

边界

已有库升级 SQL 只有在用户明确要求考虑“已有库升级”“升级 SQL” “测试服/线上升级”或等价场景时才纳入任务。未明确要求时，不要主动规划、创建或提醒 deploy/install/data/upgrade/ / backend/install/data/upgrade/ 升级 SQL；先按当前任务真相源收口。

如需判断是否应该考虑升级 SQL，先读取并遵循 thinkPHP/upgrade-sql-explicit-request。

背景

全新安装会按顺序执行 schema/*.sql。但已部署环境（测试服 / 线上）不会重装，新增的 schema 文件不会自动补到这些库上 —— 典型故障：代码引用了新表，线上报 Base table or view not found。但这类已有库升级只在用户明确要求时纳入任务。

强制规则

schema 文件是唯一真相源：所有表/字段/seed 变更必须直接改 deploy/install/data/schema/*.sql，保证全新安装即正确。
按需产出增量升级 SQL：只有用户明确要求处理已有库升级时，才在 deploy/install/data/upgrade/ 下新增一个对应的增量文件，命名 YYYY_MM_DD_<简述>.sql（如 2026_05_20_payment_log.sql）。
升级 SQL 必须幂等，可重复执行无副作用：
- 建表用 CREATE TABLE IF NOT EXISTS，禁止 DROP TABLE。
- 加字段 / 加索引前先判断是否已存在再 ALTER，或用等效幂等写法。
- seed 用 INSERT ... ON DUPLICATE KEY UPDATE 或先 DELETE 再 INSERT。
升级文件不入库：deploy/install/data/upgrade/ 已在 .gitignore，增量 SQL 属于按环境手动执行的运维产物，不提交 git。
升级文件结构须与对应 schema 文件保持一致（同一张表的定义两边不能漂移）。

暂不做

不写统一升级脚本：升级动作可能不止 SQL（静态文件、配置等），暂由人工按需执行，不强行抽象成一个脚本。
不建升级追踪表：靠 SQL 自身幂等保证可重复执行，不维护 mb_schema_upgrade 之类的记录表。

标准动作

改结构：编辑 deploy/install/data/schema/<对应>.sql（真相源）。
若用户明确要求已有库升级：在 deploy/install/data/upgrade/ 新增幂等的 YYYY_MM_DD_<简述>.sql。
若产出了升级 SQL，再通知用户两件事：
- 本地 / 全新环境：清库重装即可拿到新结构。
- 已部署环境（测试服 / 线上）：手动执行对应升级 SQL，例如 mysql -h<HOST> -u<USER> -p <DB> < deploy/install/data/upgrade/<文件>.sql
commit / PR / 文档只提及 schema 改动，不提及 upgrade 文件（其不入库）。

反例

❌ 用户明确要求已有库升级时，只改 schema/10_xxx.sql，不补 upgrade 增量
❌ upgrade 文件里写 DROP TABLE                  ← 重复执行会丢数据，非幂等
❌ 把 deploy/install/data/upgrade/*.sql 提交 git ← 属于运维产物，不入库
✅ schema/10_mb_payment_log.sql + upgrade/2026_05_20_payment_log.sql（CREATE TABLE IF NOT EXISTS）

Plus depuis ce dépôt

même dépôt

extension-slots

yyw-code/MallBase

MallBase 扩展槽边界规范；涉及会员、积分、分销、余额、优惠等权益扩展接入订单、商品编辑或 UniApp 展示时使用。

2026-07-06209

thinkphp

yyw-code/MallBase

MallBase ThinkPHP 后端规则索引；仅在需要浏览或选择后端规则、且无法确定具体 ThinkPHP skill 时使用。

2026-07-05209

upgrade-sql-explicit-request

yyw-code/MallBase

MallBase 已有库升级 SQL 边界规则；只有用户明确要求考虑已有库升级、测试服/线上升级或 upgrade SQL 时使用。

2026-07-05209

model-field-accessor-first

yyw-code/MallBase

MallBase ThinkPHP 模型字段访问器与素材回显规则；在 Model 字段读写、访问器、修改器、with 关联、素材 ID 回显或 Service 字段组装优化时使用。

2026-06-18209

preview-branch-boundary

yyw-code/MallBase

MallBase preview 演示站分支边界规则；涉及 preview 分支、演示站专用功能、main 与 preview 合并、反向合并、演示站部署或公开演示能力修改时使用。

2026-05-30209

payment-notify-idempotency

yyw-code/MallBase

MallBase 支付回调（notify）验签、幂等、防重放与金额校验规则；处理任意支付渠道（微信 / 支付宝 / 银联）回调链路时使用。

2026-05-15209

Skill: dev-schema-upgrade-sql

适用场景

在 deploy/install/data/schema/*.sql 增加/修改字段、表、初始数据

在 deploy/install/data/demo/*.sql 增加/修改演示数据

任何 mb_setting / mb_goods / mb_user 等表的 seed 调整

边界

如需判断是否应该考虑升级 SQL，先读取并遵循 thinkPHP/upgrade-sql-explicit-request。

背景

强制规则

schema 文件是唯一真相源：所有表/字段/seed 变更必须直接改 deploy/install/data/schema/*.sql，保证全新安装即正确。

按需产出增量升级 SQL：只有用户明确要求处理已有库升级时，才在 deploy/install/data/upgrade/ 下新增一个对应的增量文件，命名 YYYY_MM_DD_<简述>.sql（如 2026_05_20_payment_log.sql）。

升级 SQL 必须幂等，可重复执行无副作用：

建表用 CREATE TABLE IF NOT EXISTS，禁止 DROP TABLE。
加字段 / 加索引前先判断是否已存在再 ALTER，或用等效幂等写法。
seed 用 INSERT ... ON DUPLICATE KEY UPDATE 或先 DELETE 再 INSERT。

升级文件不入库：deploy/install/data/upgrade/ 已在 .gitignore，增量 SQL 属于按环境手动执行的运维产物，不提交 git。

升级文件结构须与对应 schema 文件保持一致（同一张表的定义两边不能漂移）。

暂不做

不写统一升级脚本：升级动作可能不止 SQL（静态文件、配置等），暂由人工按需执行，不强行抽象成一个脚本。

不建升级追踪表：靠 SQL 自身幂等保证可重复执行，不维护 mb_schema_upgrade 之类的记录表。

标准动作

改结构：编辑 deploy/install/data/schema/<对应>.sql（真相源）。

若用户明确要求已有库升级：在 deploy/install/data/upgrade/ 新增幂等的 YYYY_MM_DD_<简述>.sql。

若产出了升级 SQL，再通知用户两件事：

本地 / 全新环境：清库重装即可拿到新结构。
已部署环境（测试服 / 线上）：手动执行对应升级 SQL，例如 mysql -h<HOST> -u<USER> -p <DB> < deploy/install/data/upgrade/<文件>.sql

commit / PR / 文档只提及 schema 改动，不提及 upgrade 文件（其不入库）。

反例

❌ 用户明确要求已有库升级时，只改 schema/10_xxx.sql，不补 upgrade 增量 ❌ upgrade 文件里写 DROP TABLE ← 重复执行会丢数据，非幂等 ❌ 把 deploy/install/data/upgrade/*.sql 提交 git ← 属于运维产物，不入库 ✅ schema/10_mb_payment_log.sql + upgrade/2026_05_20_payment_log.sql（CREATE TABLE IF NOT EXISTS）