关于 i4h-workflow
i4h-workflow 是一项路由技能,用于了解 i4h 仓库当前架构和支持的工作流,并将后续操作交给专门的阶段技能。它读取仓库文档和实时支持情况,而非依赖静态列表;自身不执行安装或工作流。
主要功能
- 01解析或克隆基础检出目录
- 02读取实时支持情况和 DESIGN.md
- 03列出当前支持的工作流
- 04概述架构与职责划分
- 05将任务路由到专门阶段技能
适用场景
- 01查询支持的工作流模式
- 02了解 Scene、Task 和 Engine 的职责
- 03为工作流任务选择对应技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nvidia/ skills --skill i4h-workflow安装后在 Claude Code 中输入/i4h-workflow确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
BENCHMARK.mdskill-card.mdskill.oms.sigevals/evals.jsonreferences/repo-map.md详细介绍
i4h 工作流
目的
根据仓库的实时事实引导用户,然后将执行交给最合适的阶段技能。
说明
- 运行基础检出目录解析器。
- 阅读实时支持信息和
DESIGN.md。 - 回答时仅使用当前架构事实。
- 执行时使用最合适的阶段技能。
解析检出目录
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。切勿替换现有检出目录。
回答前先检查
阅读 ./DESIGN.md 了解架构,并阅读 skills/i4h-workflow/references/repo-map.md 了解归属信息。发现当前支持情况,不要照搬静态表格:
./run.sh list
如果因设置未完成而导致发现失败,请说明这一限制,并转到 i4h-workflow-setup。
说明设计
保持摘要准确:
- Scene 拥有模拟世界、资源、具身、摄像头、随机化、适配器和重置钩子。
- Task 拥有一项可复用能力。它读取
ctx.scene、写入ctx.act,且绝不推进模拟器。 - Workflow 选择一个 Scene,提供特定运行模式的
TaskGraph构建器,并拥有目标语义。运行模式说明该工作流应如何运行;代码和 CLI 使用更简短的术语mode。 - Engine 调度图节点;只有共享的
SimulationRunner才会重置、步进、渲染、记录、重试整个回合并输出运行摘要。 - 在线 RL 是独立的训练生命周期:其训练器负责向量化步进,并将检查点交给常规策略 Task 和
SimulationRunner验证路径。 - 与模拟器兼容的导出 RSL-RL actor 可以作为进程内 Task 运行;不兼容的基础模型策略栈则仍在远程运行。
- 远程策略栈在进程外运行,并通过 Zenoh 通信;离线数据集工具独立于模拟器。
- Python 负责行为。Manifest 在依赖边界之间传递事实。
不要描述已弃用的环境 YAML、按模式划分的运行器或独立的策略/Arena 启动器。
路由后续操作
| 目标 | 技能 |
|---|---|
| 安装、同步或修复依赖项 | i4h-workflow-setup |
| 创建新工作流/环境 | i4h-workflow-create |
| 编辑现有场景、摄像头、任务或成功规则 | i4h-workflow-scene-edit |
| 录制演示 | i4h-workflow-dataset-teleop |
| 回放 HDF5 | i4h-workflow-dataset-replay |
| 增强 HDF5 | i4h-workflow-dataset-mimic |
| 使用 VLM 对 HDF5 评分/筛选 | i4h-workflow-dataset-annotate |
| 将 HDF5 转换为 LeRobot | i4h-workflow-dataset-convert |
| 在浏览器中检查 LeRobot | i4h-lerobot-viz |
| 微调由 manifest 支持的策略任务 | i4h-workflow-finetune |
| 在模拟中对受支持的策略进行 RL 后训练 | i4h-workflow-train-rl |
| 运行策略或基于规则的 rollout | i4h-workflow-validate |
| 运行维护中的完整流水线 | i4h-workflow-e2e |
对于 Stop all,不要加载阶段技能。从仓库根目录运行 ./stop.sh all,并报告已停止的进程数。
故障排除
如果发现失败,请检查解析后的检出目录并运行设置流程。如果某种模式不存在,请说明该模式不受支持。
前置条件
需要可读取的基础检出目录,或可访问网络以克隆仓库。
限制
此路由器不会安装、编写、模拟、处理数据、训练或评估。
示例
What does the i4h workflow include, and where should I start?→ 检查实时支持情况,概述DESIGN.md,并推荐一个阶段技能。
完成门槛
回答时提供当前可用的工作流/模式列表、简短的架构摘要,以及一个具体的下一步技能。如果 run.sh list 中没有用户请求的工作流或模式,请说明不支持,而不要编造命令。