mcpField
I
i4h-workflow-e2e

i4h-workflow-e2e

github.com/nvidia开发3.8k75 次安装今天更新
代码仓库

关于 i4h-workflow-e2e

i4h-workflow-e2e 是一项技能，通过维护的驱动程序运行 i4h 工作流流水线。它要求先成功完成试运行，在前台执行，并在报告结果前检查各阶段产物和日志。

主要功能

  1. 01解析基础检出目录和 policy 工作流
  2. 02要求驱动程序试运行成功
  3. 03在前台运行维护的驱动程序
  4. 04检查流水线各阶段产物
  5. 05保留失败运行并检查阶段日志

适用场景

  1. 01端到端运行受支持的 policy 工作流
  2. 02检查录制、数据集和可视化输出
  3. 03验证训练检查点和验证结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nvidia/skills --skill i4h-workflow-e2e

安装后在 Claude Code 中输入/i4h-workflow-e2e确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

BENCHMARK.md
skill-card.md
skill.oms.sig
evals/
evals.json

详细介绍

端到端运行工作流流水线

用途

使用维护中的驱动程序，确保阶段解析、制品、日志和检查点交接与当前工作流/任务清单保持一致。

说明

  1. 解析基础检出和策略工作流。
  2. 要求驱动程序试运行成功。
  3. 在前台执行维护中的驱动程序。
  4. 检查每个阶段的制品，然后再报告完成情况。

解析检出

export I4H_WORKFLOWS_REPO_URL="${I4H_WORKFLOWS_REPO_URL:-https://github.com/isaac-for-healthcare/i4h-workflows}"
I4H_REPO_DIR_NAME="${I4H_WORKFLOWS_REPO_URL%/}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME##*/}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME##*:}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME%.git}"
[ -n "$I4H_REPO_DIR_NAME" ] || { echo "Cannot derive a checkout name from I4H_WORKFLOWS_REPO_URL" >&2; exit 2; }
ROOT="${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}"
if [ ! -d "$ROOT/workflows/i4h_workflows" ]; then
  ROOT="${I4H_WORKFLOWS:-$HOME/$I4H_REPO_DIR_NAME}"
  [ -d "$ROOT/workflows/i4h_workflows" ] || git clone "$I4H_WORKFLOWS_REPO_URL" "$ROOT"
fi
export I4H_WORKFLOWS="$ROOT"
cd "$ROOT"

将此解析器视为技能契约的一部分：托管副本可能在基础仓库之外运行，因此绝不要假定当前检出包含 workflows/i4h_workflows。I4H_WORKFLOWS_REPO_URL 用于选择克隆源。未设置 I4H_WORKFLOWS 时，根据该 URL 推导备用目录；仅在复用或选择特定目标位置时设置 I4H_WORKFLOWS。绝不要替换现有检出。

要求工作流采用 policy 模式。驱动程序会从实时工作流/任务清单中发现远程任务、具身配置、任务文本和可训练性。

先试运行

./scripts/e2e/run.sh --env <workflow> --dry-run

要求退出状态为 0，并检查打印出的每条命令和制品路径。试运行结果是当前阶段和后端归属的权威依据。

在前台运行

./scripts/e2e/run.sh --env <workflow>

仅当调用方需要特定位置时使用 --run-dir。仅当用户明确省略该可选阶段，或有文档记录的冒烟测试配置文件要求时，才使用 --skip-mimic、--skip-annotate、--skip-replay 或 --skip-viz。

将驱动程序作为此 Agent 在前台调用的工具。不要使用子 Agent、监控任务、Shell 后台运行、nohup、tmux 或脱离终端的进程。持续轮询直至退出。

驱动程序会执行完整设置，然后负责其阶段顺序、带时间戳的运行目录、runs/.latest 链接和每阶段日志。不要用手动拼凑的子集替代它。

验证

成功后，检查打印出的摘要和制品：

  • 策略录制
  • 适用时的扩展/过滤 HDF5
  • 启用时的可见回放结果
  • LeRobot 元数据、parquet 文件和视频
  • 启用时的可视化工具 URL/内容
  • 可训练时的训练日志和确切检查点
  • 检查点验证录制和最终成功摘要

失败时，在第一个失败阶段停止，检查该阶段的日志，保留运行目录，并修复所属阶段后再重新运行。不要仅为获得绿色摘要而跳过必需的失败。使用 ./stop.sh all 停止残留进程。

故障排除

根据第一个失败阶段及其日志选择负责该阶段的技能。保留运行目录，并仅在该阶段验证其输出后重新运行。

前提条件

对每个启用的阶段，都要求具备策略工作流以及主机、模拟器、后端、VLM、数据集、训练和可视化依赖项。

限制

该流水线仅支持具有策略模式的工作流；仅推理任务会跳过微调和检查点验证。

示例

  • Run end-to-end smoke pipeline for scissor pick-and-place. → 试运行、执行驱动程序，并报告从录制到验证的每个阶段。

完成门槛

报告工作流/任务/具身配置/可训练性、试运行结果、运行目录、每个阶段的结果及跳过情况、数据集/可视化工具/检查点/验证制品、最终退出状态和清理状态。

评论

支持 Markdown