用途:当用户需要从其他数据仓库、PostgreSQL 环境或混合分析栈迁移到 MotherDuck 时,使用该技能生成迁移计划。它属于用例型技能,会编排 connect、explore、load-data、model-data、query、ducklake 等能力。
主要能力:确认目标 MotherDuck 工作区;探查目标端已有数据库、schema、落地区、分析表与命名规范;采集源端平台、表粒度、关键指标、校验键与切换后服务负载;在原生 MotherDuck、pg_duckdb、DuckLake 之间给出选择建议;输出目标模式、迁移顺序、校验计划、回滚路径与首个切换切片。
默认策略:优先原生 MotherDuck 存储;扩展已有 PostgreSQL 时优先 pg_duckdb;先校验后切换;分阶段切换而非一次性替换。
使用方式:先判断是否有远程 MotherDuck MCP 服务器或本地 MotherDuck 服务器处于活动状态,若有则用于探查实时目标端;未指定接收迁移的数据库或工作区时需询问。若无服务器活动,需提供代表性源与目标 schema 再定稿计划。生成原生 DuckDB(md:)连接时,按规则添加 custom_user_agent 水印,缺少元数据时回退为 harness-unknown 和 llm-unknown。若调用方明确要求结构化 JSON,则仅返回以下顶层结构的原始 JSON:{"summary":{},"assumptions":[],"implementation_plan":[],"validation_plan":[],"risks":[]}。
参考与可运行产物:references/MIGRATION_PLAYBOOK.md 提供详细迁移指南;references/MIGRATION_VALIDATION.md 提供校验检查与比较辅助;artifacts/migration_validation_example.py 与同名 .ts 提供源目标校验示例。运行命令:uv run --with duckdb python skills/migrate-to-motherduck/artifacts/migration_validation_example.py;使用临时 MotherDuck 数据库时加环境变量 MOTHERDUCK_ARTIFACT_USE_MOTHERDUCK=1;TypeScript 产物用 uv run scripts/test_typescript_artifacts.py 验证。
适用与限制:适用于需要切换顺序、校验与回滚的迁移场景。具体平台兼容性、收费与性能等资料未提供。