mcpField
I
i4h-workflow-setup

i4h-workflow-setup

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

关于 i4h-workflow-setup

用于准备 i4h 工作流运行环境并检查工作流发现与 lint 的技能。它将主机预检和完整设置，与需要 Isaac Sim 或实际运行的检查区分开来。

主要功能

  1. 01解析或复用基础检出目录
  2. 02检查主机与运行环境要求
  3. 03执行默认完整设置
  4. 04验证工作流发现与 lint
  5. 05报告故障及后续烟雾测试命令

适用场景

  1. 01准备 i4h 工作流环境
  2. 02检查主机是否满足要求
  3. 03验证发现的工作流及 lint 结果

安装

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

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

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

包含的文件

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

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

详细介绍

i4h 工作流设置

目的

准备完整的运行环境，然后验证轻量依赖的工作流发现功能正常。

说明

  1. 确定基础检出目录。
  2. 运行所有主机预检。
  3. 运行默认的完整设置。
  4. 验证发现功能和 lint --all。

确定检出目录

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。绝不要替换已有检出目录。

预检

uname -srm
command -v uv
command -v git
nvidia-smi
df -h .
./setup.sh --help

要求使用受支持的 Linux，并运行在 x86_64 或 aarch64 架构上；还需具备 uv、Git、用于获取缺失软件包和资源的网络访问权限、充足的磁盘和模型缓存空间，以及与仓库 Isaac Sim 版本兼容的 NVIDIA 驱动。请从 ./README.md 读取当前的准确要求；不要依赖记忆中的版本号。仅当所请求的本地 VLM 或 Cosmos 服务需要 Docker 时，才要求安装 Docker。

同步

运行默认的完整设置：

./setup.sh

对应的显式命令为：

./setup.sh all

仅当用户明确要求完整重建或清理时，才使用 ./setup.sh clean，因为它会删除生成的缓存、组件环境和第三方检出目录。设置过程可幂等执行；不要把清理当作通用修复手段。设置脚本会还原固定版本的第三方源和上游 Isaac Sim 技能目录；不要将该目录复制到 skills/ 中。

验证

./run.sh list
./run.sh lint --all
test -f ./third_party/IsaacSim-045ca8b/skills/SKILLS.md

如果用户指定了某个工作流，请使用 run.sh show <workflow> --mode <mode>。这些检查无需导入 Isaac Sim，即可验证发现功能和契约。实际运行验证请使用 i4h-workflow-validate。

故障排除

发生故障时，报告最先出现的主机、网络、检出目录或 uv 同步错误；只有在修正该原因后，才重新运行完整设置。

先决条件

要求使用受支持的 Linux，具备网络访问权限、uv、Git 和充足的磁盘空间；使用模拟器还需要兼容的 NVIDIA GPU 和驱动。

限制

设置过程不会下载所有可选检查点，也无法证明任何运行过程都能成功。clean 会破坏生成的环境和第三方检出目录。

示例

  • 在这台机器上设置 i4h 工作流，并告知我是否缺少任何主机要求。 → 预检，运行默认的完整设置，然后运行发现检查和 lint --all。

完成条件

报告每项主机检查、已同步的目标、首个失败组件（如有）、发现和 lint 的结果，以及最简的下一步冒烟测试命令。仅凭设置过程，不要声称模拟器或策略运行成功。

评论

支持 Markdown