woocommerce-upgrade-safety

用途：在 WooCommerce 插件向现有商户发布新版本前，审查升级对既有安装的影响，只关注版本间差异，不评估新代码本身质量。适用于次版本或主版本发布，尤其是包含数据库结构变更、设置重构、新功能声明或钩子弃用时；纯修复补丁可跳过。也适用于支付流程变更，如新令牌化方式、API 版本升级。\n\n主要能力：先对比旧版与目标版生成差异摘要，包括文件、数据库结构、设置字段、钩子与支付令牌模式、最低版本要求。随后分步检查：数据库迁移是否使用 dbDelta 等安全模式、是否幂等、是否有版本门控、是否批量处理以应对大量订单；支付连续性包括已保存令牌、活跃订阅续费、待处理交易与 webhook 向后兼容；钩子与过滤器兼容包括移除或改名的弃用提示、签名变更、HPOS 与区块结账等新功能声明；回滚与 WordPress 自动更新安全性；更新日志、升级通知与版本元数据。最终输出 upgrade-safety-report.md，含升级风险等级（LOW/MEDIUM/HIGH/CRITICAL）、各检查项状态表和按严重程度排序的问题清单，并给出是否阻止发布的建议。\n\n必要用法：用 git diff v<old>..v<new> --stat、git diff v<old>..v<new> -- src/Data/ includes/class-*-install.php 比较版本，并按 references/woocommerce-apis.md、references/security.md、references/plugin-architecture.md 中的模式审查。\n\n限制：不评估代码质量、安全性或用户体验，这些由其他审查技能负责；仅针对版本增量而非绝对质量。资料未提供具体命令输出示例、报告生成脚本或自动化触发方式。