用途:当用户已有 NeMo Flow 代码、示例、集成、文档、清单或仓库代码,希望转换为 NeMo Relay 时使用。迁移视为机械重命名加语言特定验证,而不是行为重写;在广泛重命名前需先明确兼容性例外。
工作流:先检查工作树,识别涉及的 Rust、Python、Node.js、Go、C FFI、CLI/配置、文档或集成。解析 SKILL_DIR 为含 SKILL.md 的绝对目录,TARGET_PATH 为源仓库或目标项目。编辑前先以试运行方式执行辅助脚本:python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" --rename-paths。与用户复核报告的文本编辑、路径重命名和遗留项目配置警告。不要把项目本地 .nemo-flow/config.toml 或 .nemo-flow/plugins.toml 迁移到 .nemo-relay,这些设置需复核后手动迁移到受支持的用户或显式配置路径。获得对目标根的明确确认后,再以 --write、--rename-paths 和 --confirm-root "$TARGET_PATH" 重跑,并按语言清理包管理锁文件、生成产物和公开 API 示例,最后搜索残留 Flow 名称并验证各语言面。
重命名映射:品牌与仓库 NeMo Flow -> NeMo Relay、NeMo-Flow -> NeMo-Relay;Python nemo-flow -> nemo-relay、nemo_flow -> nemo_relay、python/nemo_flow -> python/nemo_relay;Rust nemo-flow -> nemo-relay、nemo-flow-adaptive -> nemo-relay-adaptive、nemo_flow:: -> nemo_relay::;Node.js nemo-flow-node -> nemo-relay-node 及相关入口;Go 模块路径与包别名对应更新;C FFI 的 nemo_flow.h -> nemo_relay.h、nemo_flow_* -> nemo_relay_、NemoFlow -> NemoRelay*、NEMO_FLOW_* -> NEMO_RELAY_;CLI/配置 nemo-flow -> nemo-relay、~/.config/nemo-flow -> ~/.config/nemo-relay、NEMO_FLOW_ -> NEMO_RELAY_、x-nemo-flow- -> x-nemo-relay-*。不要替换裸 flow、Flow 或 FlowError。
辅助脚本:默认试运行,除非传入 --write;跳过常见 vendor、构建、缓存和生成目录;除非传入 --include-lockfiles 否则跳过锁文件;跳过符号链接和含凭据的 dotenv 文件;检测项目本地 .nemo-flow 配置并保持原样、报告需手动迁移;写入前需以 --confirm-root 重复已复核的目标根,拒绝文件系统根或主目录写入;不跟随符号链接,在不支持相应保证的平台拒绝写入模式;使用原子无替换路径重命名,任一变更失败即非零退出;可用 --rename-paths 报告或执行路径重命名;仅重写明确的 NeMo Flow 标识符、包名、仓库名、配置路径、头文件、环境变量和 FFI 类型前缀。该脚本不会把任意 JSON、YAML、TOML 或 INI 归类为机密,需复核试运行报告中的每个配置文件;若有未复核或含凭据文件,不要对该根使用 --write,改为手动应用已复核更改。
用法示例:设置 SHELL 安全的绝对路径后运行;仅当用户希望直接编辑锁文件时才使用 --include-lockfiles,否则用 Cargo、uv/pip、npm 或 Go 工具重新生成。
验证:搜索残留标识符 rg -n "NeMo Flow|NeMo-Flow|nemo_flow|nemo-flow|NEMO_FLOW|NemoFlow|nemo_flow.h|nemo_flow_";对各语言面运行针对性测试,如 Rust 的 cargo test、Python 的导入检查与测试、Node.js 的安装类型检查与包测试、Go 的 go test ./...,仅文档迁移时构建或链接检查文档。相关技能:nemo-relay-get-started、nemo-relay-instrument-calls、nemo-relay-debug-runtime-integration。
限制:资料未提供收费标准、平台支持范围与效果保证;迁移需人工复核配置与凭据文件,脚本对项目本地 .nemo-flow 配置不做迁移。