用途:将当前智能体的数据导出为结构化迁移包(tar.gz),用于迁移离开 Starchild 或备份状态,接收方用 agent-import 技能导入。
主要能力:打包的目录结构包含 migration/manifest.json(必需,含 version、source、created_at、description)、memory/agent.json(智能体积累的知识条目)、memory/user.json(关于用户的了解)、identity/profile.json(名称、vibe、emoji、creature)与 identity/soul.md(自由格式行为指南,50 行以内)、user/settings.json(姓名、称呼、IANA 时区、BCP-47 语言码)、tasks/tasks.json(任务标题、schedule 支持 cron(UTC)、interval、delay,channels 可选 web/tg/wechat)、env/keys.json(仅列环境变量名与 label、required,不含值)、files/(任意文件,保留子目录结构)。除 manifest.json 外所有文件可选。
使用方式:先收集数据并映射到上述格式,再创建目录 mkdir -p migration/{memory,identity,user,tasks,env,files},写入 JSON 文件后用 cd migration && tar czf ../migration-bundle.tar.gz . && cd .. 打包。上传前先运行守卫脚本 python3 "$SKILL_DIR/scripts/export.py" --check-relay || exit 1(SKILL_DIR 应为包含该 SKILL.md 的绝对路径),若退出非零则中止上传,此时包仍可作为本地备份。随后用 curl -s -X POST https://sc-agent-migration.fly.dev/paste -H "Content-Type: application/octet-stream" --data-binary @migration-bundle.tar.gz 上传,从响应中提取 code 与 download_token,两者都需交给用户。可用 tar tzf migration-bundle.tar.gz 验证路径以 ./ 开头。
限制:迁移码 1 小时过期且单次使用,下载 token 是唯一下载授权不可丢失;包内不得含密钥值,环境变量仅写名称;relay 仅接受来自外部智能体平台的包;缺失信息暂未提供。