001 / VIDEO / IGUANA LAB ORIGINAL
Video Pipeline Doctor
ComfyUIや各提供元のログから、AI動画生成が失敗した原因の候補と、再試行してよいかを根拠つきで整理します。
何をするものか
AI動画の生成が失敗したとき、もう一度お金をかけて生成し直す前に、手元の記録から原因を切り分けるための道具です。
ComfyUI、Runway、fal、Replicate、FFmpeg のジョブが落ちたときに、ログや提供元のレスポンスを読み、「観測された症状」と「原因の仮説」を分けて説明します。症状をそのまま原因と言い換えないこと、根拠のない数字を足さないことが、この Skill の設計の中心にあります。
診断は2層に分かれています。同梱の CLI が決まった手がかり(シグネチャ)を機械的に拾い、その上でエージェントが文脈を読んで仮説の順位をつけます。CLI が一致した手がかりを、確定した原因へ格上げしないと SKILL.md に明記されています。
使い方の流れ
- 失敗した処理を特定し、秘密情報を伏せたログまたはレスポンスを用意する
- 同梱のスキャナを先に走らせる
node scripts/cli.mjs diagnose --incident incident.json --json個別のファイルを渡す場合は --log --response --workflow --context、提供元を指定する場合は --provider を使います。
- ComfyUI ではエラーのノードIDをワークフローと突き合わせる。ただしノードが存在することは、それが実行された証明にはなりません
- 出力を読み、原因の順位・再試行の判断・次の確認手順を受け取る
気をつけること
エンコード、保存、Webhook の配送で失敗しているときに、生成からやり直してはいけません。まず元のジョブを突き合わせ、すでにできている成果物を回収します。
提供元が「完了」と返していても、使えるメディアができている証明にも、Webhook が届いた証明にもなりません。一致するログが無いことも、成功の証明にはなりません。
導入
配布元の掲載内容と照合したコマンドです。実行すると配布元のリポジトリから取得されます。コピーできたことと、導入できたことは別です。実行後に結果を確かめてください。
npx skills add https://github.com/iguanagonzaresu-lab/-skill- --skill video-pipeline-doctor必要なもの
- Node.js 22 以上
- APIキー不要・追加パッケージのインストール不要
- 診断の材料となるログ、提供元のレスポンス、ComfyUIのワークフローのいずれか
できること
- ログ・提供元のレスポンス・ComfyUIワークフローを読み、失敗の種類と段階を切り分ける
- 最有力の原因と、それに対立する説明を、根拠の場所と強さつきで示す
- 再試行の判断を DO_NOT_RETRY_AS_IS / RETRY_LATER / CHECK_STATUS_FIRST / NO_RETRY_NEEDED / UNKNOWN の5区分で返す
- 優先順位をつけた修正案と、次に確認すべき一手を出す
- diagnosis.schema.json に沿った機械可読の出力を返す
できないこと
配布元の SKILL.md に明記されている範囲外です。
- 動画を生成しない。自動修復も自動再試行も行わない
- CLIはネットワークへ出ない。ジョブの再送、ワークフローの変更、依存のインストール、環境コマンドの実行、ファイルの書き出しをしない
- v0.1 は実行環境(GPU・VRAM・バージョン・カスタムノード)を自動収集しない
- 数値の信頼度、VRAMの削減量、既知の不具合、フレーム上限を作り出さない
- 別のLLM APIは同梱していない。推論部分は利用者側のエージェントが担う
安全性について
以下は配布元の記述にある設計方針です。当方で実行して確かめた結果ではありません。導入前にご自身でコードを確認してください。
- APIキー、署名付きURL、非公開のメディアを要求しない設計になっている
- 報告には生のメッセージ、プロンプト、認証情報、メディアURLを含めない方針が明記されている
- ログに書かれた指示は「信用できないデータ」として扱う前提になっている
