Checkout / Customer account UI 拡張機能の API バージョン更新と Polaris Web Components 化を、AI コーディングエージェントに肩代わりさせる新スキル。React→Preact 変換やレガシーコンポーネント置換といった手作業を圧縮できる。2026年10月1日以降は移行が必須。
React→Preact の書き換え、レガシーコンポーネントの対応表づくりと置換、拡張 API の更新を、開発者が一つずつ手で進める必要があった。
AI Toolkit ＋ 強化された開発者ドキュメントをエージェントが参照し、必要な移行ステップを順に実行。開発者はレビューと仕上げに集中できる。
レガシー React 拡張を Preact ベースへ変換する処理を扱う。
レガシーコンポーネントを Polaris Web Components に対応付け（マッピング）して置き換える。
拡張機能が使う API を新バージョンに合わせて更新する。
Shopify CLI は、1 年より古い API バージョンの拡張機能を含むアプリの更新をブロックする。
| 項目 | 内容 |
|---|---|
| 期限 | 2026年10月1日 以降の「将来のアプリ更新」に必須 |
| ブロック対象 | Checkout / Customer account UI 拡張機能が API バージョン 2025-07 以前のアプリ |
| 起きること | 該当アプリは 更新不可（Shopify CLi が更新をブロック） |
| 解決ライン | API バージョン 2025-10 以降へ更新（2025-10 以降はデフォルトで Polaris Web Components） |
Polaris Web Components で構築した拡張機能は、レガシー React 拡張に比べて描画が大幅に速い。読み込み時間と拡張機能のパフォーマンスが最適化される。
API バージョン 2025-10 以降は、すべて Polaris Web Components がデフォルトで使われる。最新へ上げること自体が Polaris 化につながる。
Shopify AI Toolkit をインストールする。
移行用 dev docs（Checkout / Customer account 各ドキュメント）を参照する。
使っている AI エージェント上で移行スキルを走らせる。
この日以降、API バージョン 2025-07 以前の Checkout / Customer account UI 拡張を含むアプリは更新不可になる。後回しにすると将来のアップデート自体が止まる。
Shopify CLI は 1 年より古い API バージョンの拡張を含むアプリの更新をブロックする。期限は固定値ではなく「バージョンの古さ」で決まる構造である点に注意。
React→Preact、レガシー→Polaris Web Components のコンポーネント置換、拡張 API 更新。単なる依存バージョン上げではなく、レンダリング基盤とコンポーネントの作り替えを伴う。
Polaris Web Components 拡張はレガシー React 拡張より描画が大幅に速い。読み込み時間とパフォーマンスの改善が、移行のもう一つの実利になる。
AI Toolkit ＋ ドキュメントはエージェントに移行手順を供給するが、変換結果の妥当性確認は開発者の役割。記事には自動移行の精度・成功保証や、対象 API・対応エージェントの具体名までは記載なしのため、実機での検証前提で進めるのが安全。