关于 prestashop-update-check
用于检查 PrestaShop 商店是否具备更新条件的技能。它检查兼容性和版本、审视报告的文件改动及已知问题,并给出是否继续的建议,但不会自动修复问题。
主要功能
- 01列出可用更新版本
- 02检查商店要求
- 03审查已修改的核心和主题文件
- 04查询 Update Assistant 已知问题
- 05按严重程度汇总检查结果
适用场景
- 01安排更新前评估准备情况
- 02审视商店自定义文件带来的风险
- 03判断是否继续执行更新
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ prestashop/ skills --skill prestashop-update-check安装后在 Claude Code 中输入/prestashop-update-check确认已加载。
详细介绍
要求
询问用户:
- 来自商店的模块
autoupgrade的路径是什么?它可能位于 Docker 容器中,也可能需要通过 SSH 会话访问。 - 如果用户不清楚,请询问管理目录名称。运行命令时会用到它。
用法:
- Update Assistant 的命令通过
[module_path]/bin/console运行, - 在末尾添加
--help可查看命令详情。 - 参数
-q可避免显示不必要的内容。备份、更新或还原后,如果需要查看日志,可以在[admin_path]/autoupgrade/logs/中找到,文件名格式为[year]-[month]-[day]-[time]-[action].txt。
步骤
- 运行
update:check-new-version并显示可用版本(GATE)。可能会显示 3 个渠道:online_recommended(默认)、online或local。online_recommended和online不一定总会显示。local要求新版 PrestaShop 的 zip 和 xml 文件位于[shop_admin]/autoupgrade/download/。请询问用户在后续步骤中要使用哪个渠道 - 使用
update:check-requirements检查商店的兼容性。显示具体反馈时,可以执行额外检查:- 如果核心文件已被修改(
index.php文件和模块除外),可以通过与 GitHub 上的原始文件进行差异比较,评估这些更改对商家的重要性。原始文件的 URL 为 https://raw.githubusercontent.com/PrestaShop/PrestaShop/refs/tags/[prestashop_source_version]/[path_to_file_from_root_store](占位符必须替换为实际值)。如果这些更改对业务至关重要,建议将其移至 模块,以免丢失;或者作为最后的手段,使用 覆盖。 - 如果主题文件已被修改(
index.php文件除外),可以通过与 GitHub 上的原始文件进行差异比较,评估这些更改对商家的重要性。原始文件的 URL 为 https://raw.githubusercontent.com/PrestaShop/[theme_name]/refs/tags/[version_in_config/theme.yml_of_the_theme]/[path_to_file_from_root_store](占位符必须替换为实际值)。如果这些更改对业务至关重要,建议将其移至[子主题](https://devdocs.prestashop-project.org/9/themes/reference/template-inheritance/parent-child-feature/),以免丢失。此项仅适用于评估 PrestaShop 默认主题的更改:classic和hummingbird。
- 如果核心文件已被修改(
- 在 https://github.com/PrestaShop/autoupgrade/discussions/categories/known-issues?discussions_q=is%3Aopen+category%3A%22Known+issues%22+label%3A%22Impacts%3A+[version]%22 查看与当前版本的 Update Assistant 相关的帖子,将 [version] 替换为模块当前的主次版本号。运行不带任何参数的
[module_path]/bin/console即可查看该版本号。 - 如果存在错误,请逐一解释并提出修复建议,但不要自动修复任何内容。
- 最后明确给出是否可以继续的建议,并根据以下严重级别总结错误、警告和成功项。
严重级别
| 标记 | 严重级别 | 含义 |
|---|---|---|
| 🔴 | 错误 | 更新前必须修复的问题 |
| 🟡 | 警告 | 值得修复的小问题,但不会阻止更新 |
| 🟢 | 正常 | 检查未发现需要修复的问题,或已确认系统已准备就绪 |
评论
支持 Markdown