哪都通図生動画（Antigravity）
本スキルの独立した Python クライアントを使用して候補動画を生成します。デフォルトモデルは実績のある seedance-2.5 です。制作フローは特定のプロジェクト、他のワークツリー、またはデプロイ状態に依存しません。
ローカル設定と実行エントリポイント
- 統一認証情報は
NXTPATH_API_KEYで、デフォルトでは環境変数または~/.config/nxtpath/envから読み取ります。環境変数が優先され、NXTPATH_ENV_FILEで別のプライベート設定ファイルを指定できます。他のアプリケーションのチャットトークンを読み取ったり、キーをコマンドライン、スキル、レポート、タスク記録に含めたりしないでください。 - 新しい zsh プロセスは
~/.zshenvによってローカル設定をロードします。GUI や古いプロセスが環境を継承していない場合でも、クライアントは上記のファイルを直接読み取ることができます。設定の存在のみを報告し、内容は表示しないでください。 - 現在ロードされているスキルディレクトリから
scripts/nxtpath_video.pyを特定します。~/.config/nxtpath/venv/bin/pythonを優先的に使用します。これが存在しない場合、HTTPS 参照画像と動画 API は Python 3.9+ で直接実行できます。ローカル画像のホスティングには、scripts/requirements.txtの boto3 も必要です。 - ターゲットプロジェクトで、適用可能なリソースとプライバシー規約を最初に読みます。タスクはデフォルトで、そのプロジェクトで無視される
tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/に配置されます。プロジェクトがない場合は、ユーザーが選択した出力ディレクトリを使用します。古い attempt を上書きしたり、候補を自動的にビルドや正式リソースに追加したりしないでください。
1回の制作または既存タスクの再開
ユーザーが特定の動画生成を明示的に要求した場合、そのリクエストに従って1回の候補生成を完了し、一般的な確認を繰り返し求めないでください。ルート、設定、スキルの使い方についての質問は、有料生成を許可しません。バッチ数、リワーク回数、費用範囲は、今回のユーザーとの取り決めに従います。取り決めがない場合は、最初に1つだけ生成し、自動的に拡大したり、失敗したタスクを再生成したりしないでください。
run_commandを使用してdoctor --check-apiを実行し、認証情報と利用可能なモデルを確認します。これは読み取り専用リクエストであり、動画を生成しません。- 参照画像とアクションの説明を確認します（ローカル参照画像の場合は、最初に
read_fileを使用して表示します）。アクションの段階、カット、構図、時間、保持すべきキャラクターと小道具を明確にします。指定がない場合、サンプルはデフォルトで4秒/480pとし、デフォルトの低解像度サンプルを正式な完成品として扱わないでください。ネイティブフレームレート、キャラクターの一貫性、開始/終了のポーズ、透明度は、実際の動画に基づいて確認します。 - プロンプトを UTF-8 ファイルとして保存し、
prepareを使用して不変の入力を作成します。--referenceは、ローカルの PNG/JPEG/WebP または HTTPS 画像URLを繰り返し指定できます。これらは一般的なガイド画像であり、API が開始/終了のキーフレームを固定していると主張しないでください。テキストからの動画生成では、参照画像を渡す必要はありません。 - ローカル画像が存在する場合は
hostを実行し、入力スナップショットを設定済みのプライベート R2 バケットにアップロードまたは再利用し、24時間の GET 署名を発行し、ダウンロードハッシュを照合します。この操作により、参照画像がホスティングサービスと動画プロバイダーに渡されます。ユーザーがリクエストした素材の範囲内で行う必要があります。ホスティングが失敗した場合は動画を送信せず、自動的にアカウント、パブリックバケット、またはサービスを切り替えないでください。既存の HTTPS 参照画像にはhostは不要です。 submitを1回だけ実行します。最初に排他的な送信レコードを永続化してから、有料の POST を発行します。その後、独立したstatusでクエリし、成功したらdownloadでvideo.mp4を取得します。各コマンドはrun_commandを介して個別に実行し、数分単位のポーリングを1回の長いシェル呼び出しに詰め込まず、シェルのsleepをタイマーとして決して使用しないでください。待機が必要な場合は、schedule(DurationSeconds=...)を使用して1回のタイマーを設定し、現在のラウンドを終了してウェイクアップを待ち、その後再度statusを実行します。タイムアウトによって生成リクエストを再送信しないでください。- 会話をまたいで再開する場合は、元のジョブパスを使用し、最初に
inspectを実行してからstatus/downloadを実行します。既に送信済み、結果不明、またはタスクIDがない attempt に対しては、決して POST を繰り返さないでください。タスクIDがない場合は、プライベートな送信記録に基づいてプロバイダーに確認します。ダウンロードが失敗した場合は、ダウンロードのみを再試行します。401/403、クォータ不足、またはモデルが利用不能な場合は、送信を停止し、理由を報告します。キー、モデル、またはインターフェースを自動的に切り替えないでください。
コマンド例（CLIENT はスキル内の実際のスクリプトを指し、PY はローカルの Python、JOB は今回新しく作成されたタスクディレクトリです）：
"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --reference "$REFERENCE_IMAGE" --duration 4 --resolution 480p --ratio 1:1
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"
納品と境界
再生可能なローカル動画ファイルとジョブパスで納品し、[video.mp4](file:///absolute/path/to/video.mp4) リンクを使用して動画を表示し、それが候補であり、実際に確認した内容を説明します。完成品をレビューする必要がある場合は、Antigravity の read_file ツールを使用してダウンロードした video.mp4 を直接読み取り（ネイティブで動画マルチモーダル読み取りをサポート）、元の速度、重要なアクション、開始/終了のポーズを確認します。HTTP の成功をアクションやアートの承認と同等と見なさないでください。
タスク記録には、プロンプト、入力スナップショット、正確なリクエスト、プロバイダーのタスクハンドル、結果、ファイルハッシュが含まれ、デフォルトの権限は現在のユーザーのみ読み取り可能です。これらの記録には一時的な署名付き URL が含まれる場合があるため、全体をチャットに貼り付けたり Git にコミットしたりしないでください。コンソールにはタスクハンドルのフィンガープリントのみを表示します。透明な背景除去、SVG の結合、アプリ連携は後続の制作として、ターゲットプロジェクトのツールと承認に従って処理します。
デバイスの変更、認証情報の更新、またはホスティングの失敗時にのみ、設定と障害復旧 を参照してください。インターフェースの詳細については、プロバイダー Seedance Skill を参照してください。