mcpField
R
runpod-comfyui-models

runpod-comfyui-models

github.com/runpodクリエイティブ・メディア47465 回インストール2 日前に更新
リポジトリ

runpod-comfyui-models について

runpod-comfyui-models は、RunpodDirect 用の ComfyUI UI ワークフロー JSON を修復するスキルです。根拠に基づいてモデルメタデータを特定し、元ファイルを置き換えずに修正版を作成します。曖昧なモデルは推測しません。

主な機能

  1. 01ComfyUI PNG からワークフローを抽出
  2. 02モデルローダーの選択内容を一覧化
  3. 03情報源の根拠からモデルを特定
  4. 04新しいワークフロー複製にメタデータを追加
  5. 05曖昧さやアクセス制限を慎重に扱う

活用シーン

  1. 01RunpodDirect 向けワークフローメタデータの修復
  2. 02出力 PNG に埋め込まれたワークフローの復元
  3. 03メタデータ適用前の未解決モデル候補の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-comfyui-models

インストール後、Claude Code で/runpod-comfyui-modelsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
always-output-workflow.eval.md
ambiguous-filename.eval.md
api-inventory-only.eval.md
gated-model.eval.md
mixed-resolved-ambiguous-output.eval.md
nontechnical-handoff.eval.md
png-output-extraction.eval.md
repair-and-handoff.eval.md
runpoddirect-required-handoff.eval.md
support-intake.eval.md
template-recommendation.eval.md
unsafe-download-url.eval.md
reference/
metadata.md
resolution.md
runpoddirect.md
scripts/
apply_model_metadata.py
extract_png_workflow.py
inventory_workflow_models.py
tests/
test_model_metadata_scripts.py
test_png_workflow_extractor.py

詳細

RunpodDirect 用の ComfyUI ワークフローを修復する

ComfyUI-RunpodDirect が利用できる、信頼性の高い properties.models レコードを含む新しい UI ワークフロー JSON を返します。グラフをキューに追加するためだけに、もっともらしい別のモデルで置き換えてはいけません。提供された JSON や PNG を編集、置換、上書きしてはいけません。復元可能な UI ワークフローごとに、解決が未完了、不明確、アクセス制限付き、中断状態であっても、必ず新しい <workflow-stem>.repaired.json を 1 つだけ引き渡します。

用語 — workflow、prompt、metadata record の違い

用語内容ここでの役割
UI workflow JSONComfyUI フロントエンドがエクスポート／インポートするグラフ：ノード、リンク、ウィジェットの値、propertiesこのスキルが注釈を付ける唯一の JSON
API prompt JSON/prompt に POST される、ノード ID をキーとした実行形式インベントリの証拠としてのみ使用 — 注釈は付けない
properties.models recordローダーノードのモデルメタデータ項目（name、url、directory、省略可能な hash）修復で追加または修正する内容

注釈の対象は UI 形式のみです。API prompt には、移植可能なモデルメタデータの規約がありません。

受け付け

  • アーティファクトがない → 1 回だけ、正確に次のように尋ねます：「ワークフロー JSON または元の ComfyUI 出力 PNG を添付してください。」（スクリーンショットや再エンコードされた画像では、通常ワークフローが失われます。）
  • アーティファクトがある → それ以上受け付け時の質問はせず、必要に応じて抽出し、インベントリを確認し、解決して、修復したコピーを書き出し、返します。
  • 復元可能な UI ワークフローがない（API 専用 JSON、情報が除去された PNG）→ これが唯一の障害要因です。元の UI ワークフローまたは PNG を依頼します。

対応方針の決定

確認された状態対応
すべてのモデル要件に完全なメタデータがあり、報告された問題がない内容を変更せず保持し、新しい最終 JSON を 1 つ書き出して、レコードを追加していないことを報告します。明示的に依頼された場合、または実行時の失敗によって問題の証拠が得られた場合に限り、検証または強化を行います。
ファイル名は正確だが、信頼できる URL がないノードのコンテキストをインベントリで確認してから、元のテンプレートソース、ComfyUI-Manager、Hugging Face、Civitai から候補を解決します。
一般的なファイル名、または信頼できる候補が複数ある曖昧なメタデータを適用したり、ダウンロードしたりしません。部分的なワークフローを公開し、そのパスを報告してから、候補を提示し、ユーザーに選択を求めます。
アクセス制限またはライセンス制限のあるアーティファクト部分的なワークフローを先に公開してから、アクセスとライセンスへの同意が確認されるまで、認証／ダウンロードの前で停止します。
RunpodDirect のルートが利用できない修復済みワークフローを作成します。作業用マニフェストは一時的なものとして保持し、環境上必要な場合にのみ RunpodDirect を推奨または診断します。

参照資料

参照先回答する質問
reference/resolution.mdこのモデルはどのアーティファクトか。証拠、ソースの優先順位、確信度の方針。
reference/metadata.md承認済みメタデータをワークフローに書き込む方法。パッチのルール、安全でない URL の扱い、正確な引き渡し用の行。
reference/runpoddirect.mdライブ拡張機能は存在するか、安全に操作する方法。機能の検出、ダウンロードの許可、URL／リダイレクト／シークレットの安全性。

手間を最小限にするための取り決め

  • inspect / check → 読み取り専用の作業です。
  • find / repair / fix → 新しい修復済みコピーも書き出します。
  • download / make it work on this Pod → 検証済みで変更されていないタプルもダウンロードします。
  • run / test end to end → さらに、制御されたスモークテストを 1 回実行します。

最初の依頼ですでに含まれている手順を、再確認してはいけません。質問は 1 回だけにし、重要な判断が必要な場合に限ります。重要な判断とは、曖昧さ、アクセス制限やライセンス、インストールまたは再起動、コスト／ストレージの選択、または最初の依頼を超える操作です。判断が残っていない場合は、許可された作業を完了して一度だけ報告します。任意の次の手順を質問にしてはいけません。

ワークフロー

  1. 抽出（PNG 入力のみ）：python3 -B extract_png_workflow.py で、ComfyUI の出力 PNG に埋め込まれた UI workflow をタスクの一時ディレクトリに取り出します。
  2. 一覧化：python3 -B inventory_workflow_models.py で、サブグラフも含め、すべてのローダー選択項目を一覧表示します。これは証拠であり、モデルの特定には使いません。
  3. reference/resolution.md に従って各モデルを特定し、最初に見つかった verified の公開元アーティファクトで処理を止めます。レビュー用マニフェストは一時ファイルのままにします。
  4. 適用：python3 -B apply_model_metadata.py --allow-unresolved で、特定できたモデルがなくても毎回新しいワークフローを書き出します。パッチのルール、安全でない URL の処理、公開時の契約については reference/metadata.md を参照してください。
  5. ライブチェック（リクエストの範囲内のみ）：Pod の RunpodDirect ルートに対し、読み取り専用プローブをまとめて 1 回実行します。curl を使用できます。画面に見える形で連続実行するのではなく、まとめて実行してください。その後、reference/runpoddirect.md に従い、許可されたダウンロードのみを行います。

使用方法のエラーが発生した場合に限り、--help を確認してください。作業状態（抽出した JSON、一覧、マニフェスト）はタスクごとの一時ディレクトリ 1 つに保存し、修復した JSON の検証後に削除します。永続化するアーティファクトは、修復した JSON のみです。引き継ぎは平易な言葉で行ってください。正確な文言は reference/metadata.md に記載されています。

次のルーティング先

実際のタスク…送信先
ワークフロー用に Pod をプロビジョニングするgolden path 02（一覧：golden paths）、続いて runpod-mcp または runpodctl
モデルのリポジトリとファイルがすでに正確に分かっているcompanion-clis
テンプレート Pod が起動しない、またはテンプレート Pod にモデルが不足しているrunpod-templates
RunpodDirect 自体をインストールする、または理解するreference/runpoddirect.md

コメント

Markdown 対応