用途：把 Warp GUI 安装中受支持的配置子集迁移到 Warp Agent CLI，流程限定在本地，并把 GUI 文件视为不可信输入。开始前需阅读 references/migration-matrix.md。
主要能力：处理四类迁移——规则、用户/仓库技能与捆绑技能已从共享路径发现；drive 对象、保存的提示和云端执行配置在登录并同步后出现；只有 schema 声明且 GUI 与 Warp Agent CLI 共有的设置，以及原始全局文件型 MCP 定义可导入；登录、可模板化 MCP 安装、OAuth 与供应商凭据需要重新认证或重新安装。按键绑定、主题、启动/标签配置、本地工作流、shell/启动偏好、GUI 状态、命令历史和数据库不受支持。
使用方式：仅使用宿主提供的路径，不要替换为 ~/.warp 或自行推断频道/配置文件。若渲染路径为空、未解析或仍含双花括号，停止该部分迁移并报告无法解析；GUI 源配置文件不明确时按失败关闭。设置检查需 Python 3.11+，无 tomllib 则说明该运行时无法检查设置。先运行 inspect_shared_settings.py 检查共享设置，再以 --dry-run 运行 merge_mcp_config.py 并保留返回的指纹。展示脱敏后的候选设置与 MCP 计数，取得用户对每项设置新增、冲突覆盖和全局 MCP 合并的分别批准后再写入；只做外科式编辑，保留目标文件的注释、格式、未知键和专属设置。MCP 应用时传入精确的 dry-run 指纹，文件在预览后变动则拒绝写入并重新 dry run。
限制：MCP 配置文件只能由 merge_mcp_config.py 读取，不得用文件读取工具、cat、grep、shell 展开或临时脚本检查；不得打印或归纳 MCP 服务器名称、定义、命令、URL、请求头、环境变量或取值；不得复制凭据、刷新令牌、API 密钥、钥匙串/凭据存储项、安全存储、SQLite 行、MCP 安装/运行状态或 OAuth 状态。只迁移已解析的 Warp 全局 MCP 文件，不检查或迁移项目级、第三方 MCP 文件。设置仅当 x-warp-surfaces 同时含 gui 和 tui 才合格。不得覆盖 Warp Agent CLI 中未经用户明确批准的具体冲突。由本技能完成的迁移不包含登录；不得声称登录 Warp Agent CLI 会迁移本地文件。写入前若目标设置路径为符号链接则拒绝，存在时创建带时间戳的用户受限备份，不存在时以仅用户权限创建。验证只重跑检查器与 MCP dry run，不直接查看 MCP 文件。