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. 01i4h ワークフロー環境の準備
  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

x86_64 または aarch64 のサポート対象 Linux、uv、Git、不足しているパッケージやアセットを取得するためのネットワーク接続、十分なディスク容量とモデルキャッシュ容量、およびリポジトリの Isaac Sim バージョンと互換性のある NVIDIA ドライバーが必要です。現在の正確な要件は ./README.md を読み、記憶に頼ったバージョン番号を使わないでください。要求されたローカル VLM サービスまたは Cosmos サービスで必要な場合に限り、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 対応