用途：把 Dialogflow CX（DFCX）智能体迁移到 CXAS（Customer Experience Agent Studio）。技能本身是薄编排层，迁移与优化逻辑位于 cxas_scrapi 的 migration 模块，通过 MigrationService.run_stage_* 方法调用。
主要能力：migrate.py 将所选 playbook/flow 1:1 转为 IR，仅部署基础资源（app、变量、工具），智能体部署推迟到 stage_1.py，以避开 CXAS 100 智能体上限；可用 --no-consolidate 立即推送完整 1:1 集合（仅约 100 个以下安全）。stage_1.py 加载 IR，执行 optimize_stage1（变量去重）与 Gemini 结构合并（N→M 分组），首次推送合并后的智能体。stage_2.py 执行 optimize_stage2（指令状态机与工具 mock），通过 update-pass 部署并重生成单元测试、lint、写审计报告。stage_3.py 在 Stage 1 合并后按 Spoke-Hub 架构重连父子拓扑，设置 app root_agent 为 is_root 组，幂等可重跑。各阶段状态通过 <target>_ir.json（Pydantic IRBundle，含配置、源 IR、目标 IR、阶段历史、版本检查点）传递，成功才持久化。
必要用法：安装 pip install -e .；认证 gcloud auth application-default login、gcloud auth list（源需读权限、目标需管理权限）；交互提示需要 pip install InquirerPy。交互运行：python .agents/skills/cxas-dfcx-migration/scripts/migrate.py；完全脚本化示例：python .agents/skills/cxas-dfcx-migration/scripts/migrate.py --source-agent-id "projects/<src_proj>/locations/us/agents/<uuid>" --project-id <target_proj> --location us --target-name my_cxas_app --yes。仅预检预览加 --preview-only，会在源加载后生成 <target>_tree_preview.html。各阶段：python .../stage_1.py --target-name my_cxas_app，可用 --grouping-json 复放分组；python .../stage_2.py --target-name my_cxas_app；python .../stage_3.py --target-name my_cxas_app --architecture hub-and-spoke。也可用非交互 CLI：cxas migrate dfcx --run ...，以及 cxas migrate dfcx --optimize --stage 1|2|3|resume --target-name my_app。
适用场景：需要交互式驱动迁移并查看预检上下文时使用本技能；脚本化或 CI 场景使用同一 MigrationService 的 CLI 入口。
限制：location 不要默认 global，CXAS app 在多数项目位于 us；display name 重复会 AlreadyExists；stage_1/2 需先运行 migrate.py 生成 IR bundle，或显式 --ir-bundle。Gemini 合成有 600 秒每组超时，可用 SYNTHESIS_TIMEOUT_S 覆盖，超时回退为拼接指令；gemini-2.5-flash-001 不可用时迁移继续但 AI 描述为空。更多参数与 IR schema 见 references/migration-options.md。实际收费、配额与平台细节暂未提供。