prestashop-update-check について
PrestaShop ストアが更新可能な状態か確認するスキルです。互換性やバージョン、報告された変更、既知の問題を調べ、修正は行わずに実行可否を提案します。
主な機能
- 01利用可能な更新バージョンの表示
- 02ストア要件の確認
- 03変更されたコアとテーマファイルの確認
- 04Update 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] です(プレースホルダーは実際の値に置き換える必要があります)。変更がビジネスにとって重大な場合は、変更を失わないよう、子テーマに移すことを推奨します。これは、PrestaShop のデフォルトテーマである
classicとhummingbirdの変更を評価する場合に限ります。
- Update Assistant の現在のバージョンに関連する投稿を https://github.com/PrestaShop/autoupgrade/discussions/categories/known-issues?discussions_q=is%3Aopen+category%3A%22Known+issues%22+label%3A%22Impacts%3A+[version]%22 で確認します。[version] をモジュールの現在の major.minor バージョンに置き換えてください。バージョンは、パラメーターを指定せずに
[module_path]/bin/consoleを実行すると確認できます。 - エラーがある場合は、それぞれの内容を説明し、修正方法を提案します。ただし、自動的に修正してはいけません。
- 以下の重大度レベルを使って、エラー、警告、成功の概要を示し、更新を進めるかどうかを明確に推奨して締めくくります。
重大度レベル
| マーカー | 重大度 | 意味 |
|---|---|---|
| 🔴 | エラー | 更新前に必ず修正しなければならない問題 |
| 🟡 | 警告 | 軽微な問題です。修正が望ましいものの、更新を妨げるものではありません |
| 🟢 | OK | 修正すべき項目がないことを確認した、または準備が整っていることを確認したチェック |
コメント
Markdown 対応