carto-arcgis-migration

carto-arcgis-migration

ArcGIS Portal／AGOL のエンドポイントを受け取り、そのコンテンツを CARTO に移行する単一のスキルです。3 つのフェーズを順番に実行し、作業ディレクトリにある唯一の信頼できる情報源 MIGRATION_MANIFEST.md を共有します。

1. 検出 — アイテムを列挙して分類し、マニフェストに記録します。詳細は references/discover.md を参照してください。
2. データの移行 — Hosted Feature Layer と Hosted Table を CARTO のテーブルに移行します（マニフェストの Datasets セクション）。詳細は references/migrate-data.md を参照してください。
3. マップの移行 — Web Map と、シンプルな Dashboard／Web Experience／Web Mapping Application のエントリを CARTO Builder のマップに移行します（マニフェストの Web Maps + Apps セクション）。詳細は references/migrate-maps.md を参照してください。

マニフェストには状態が蓄積され、各フェーズでエントリが pending → in-progress → done／skipped／failed と更新されます。再実行は冪等です。done のエントリはスキップされ、failed のエントリは再試行されます。

アクセス方法 — CLI ネイティブ。 この移行は、ファイル上のマニフェスト、Python による抽出、carto の一括実行を伴う、バッチ処理とディスク上の状態管理を中心としたワークフローです。実際のシェルが利用できる環境（Claude Code、Codex、Antigravity など）で実行してください。ファイルシステムや Python がない MCP のみのチャットホスト（Claude.ai、ChatGPT）では実行できません。CARTO 側で行う読み取りチェック（テーブルの存在確認、列／ジオメトリの調査、インポート）には MCP による代替手段（execute_query、explore_data の describe、import_data）がありますが、全体のバッチループ、マニフェストの台帳、ArcGIS からの抽出は CLI 専用のため、このスキルでは一貫して carto CLI を使用します。ルーティングモデルについては carto-basics/references/access-paths.md を参照してください。

前提条件

• carto-skills プラグイン（このカタログ）。移行フェーズでは、インポート、クエリ、マップ作成など、CARTO 側の処理を carto-import-export-data、carto-query-datawarehouse、carto-explore-datawarehouse、carto-create-builder-maps に委任します。
• 認証済みの carto CLI（carto auth login）と、carto connections list --json に表示される接続が少なくとも 1 つあること。
• ArcGIS Portal／AGOL のエンドポイントへのアクセスと認証情報（または、完全に公開された AGOL にアクセスする場合は匿名アクセス）。
• データフェーズで GeoParquet を抽出するための geopandas + pyarrow を備えた Python。マップフェーズで Arcade から SQL への変換を検証するには sqlglot が必要です。

ユーザーのリクエストに応じたルーティング

ユーザーの依頼内容に基づいてフェーズを選択します。

ユーザーのリクエスト	フェーズ
「ArcGIS Portal を移行して」「Portal の内容を教えて」、またはアイテムを指定せず Portal／AGOL の URL を提示	検出（references/discover.md）
「データセットを移行して」「すべてのデータを移行して」、または Hosted Feature Layer／Hosted Table を指定	データの移行（references/migrate-data.md）
「マップを移行して」「シンプルなアプリを移行して」、または Web Map／シンプルなアプリのタイトルを指定	マップの移行（references/migrate-maps.md）
「移行をすべて実行して」	3 つのフェーズを順番に実行し、各フェーズの後にユーザーの確認を待ちます

ユーザーが単一のアイテムを指定した場合は、該当フェーズの対象をそのエントリに絞ります。

実行順序が重要です

• migrate- フェーズの前に検出を実行します。* マニフェストが唯一の信頼できる情報源であり、データフェーズとマップフェーズは、マニフェストがないと開始できません。
• マップの移行より先にデータを移行します。 Web Map とシンプルなアプリは、Datasets エントリで解決された Target FQN に依存します。Web Map のレイヤーが未移行のデータセットを参照している場合、その Web Map は failed（Failure: depends-on-unmigrated-data）としてマークされます。マップフェーズは migrate-data を自動実行しません。これは、ユーザーが未解決の差分を明確に把握できるようにするためです。

常時適用されるルール（スキル全体）

• すべての carto 呼び出しで --json を渡し、すべての ArcGIS REST 呼び出しで &f=json を渡してください。
• 検出中に移行しないでください。検出で書き込むのはマニフェストのみです。ユーザーが確認してから、migrate-* フェーズを実行してください。
• 状態が遷移するたびにマニフェストを更新してください。バッチの途中でクラッシュしても、マニフェストにはディスク上の実際の状態を反映させてください。
• アイテムごとの失敗でバッチを中断しないでください。ただし、CARTO の認証期限切れは例外です（--json の 401/403 を解析し、処理中のアイテムには手を加えずにバッチを停止し、ユーザーに carto auth login を実行してから再呼び出しするよう依頼してください）。
• 冪等性。done のエントリは何も通知せずにスキップします。failed のエントリは再試行します（migrate-data では --overwrite を使用し、migrate-maps ではタイトルとタグを事前確認します）。
• 移行したすべてのマップに From ArcGIS タグを付け、プライバシー設定はデフォルト（プライベート）のままにしてください。このタグは、冪等性の事前確認と顧客側でのフィルタリングに使う唯一のシグナルです。
• 作業を進めながら、学んだことを SESSION_LESSONS.md に記録し、バッチの最後に提示してください。キャッシュされたスキルファイルは決して自動編集しないでください。実行時に参照するファイルは読み取り専用です。メンテナーが上流の変更を統合します。
• 移行コードを書く前に、該当する references/*.md を確認してください。レンダラーのマッピング、ポップアップ／Arcade／ベースマップの変換、データセット設定の要件、「現場で得られた教訓」はすべてそこに記載されています。文書化済みの注意点を再発見するのは、ユーザーの時間の無駄です。CARTO プラットフォームの仕組み（carto import、carto sql query、carto maps *、carto connections *）については、フラグを推測せず、対応する carto-skill のテスト済みレシピに任せてください。