生成
パス：${CLAUDE_SKILL_DIR} はこの SKILL.md が存在するフォルダ、${CLAUDE_SKILL_DIR}/../.. はエディタフォルダ（このリポジトリの .claude/）の2階層上を示します。
ユーザーへの質問はすべて質問ボックスを使用します：AskUserQuestion ツールを呼び出してください（2～4択、推奨オプションを先頭に）。そのツールがないエージェントでは、番号付きでテキスト質問をしてください。
G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py"。python3（Windows では py）で実行します。各モデル、その入力と制限は gen.py models（lib/ai_editor/gen/models.json から）にあります。モデル ID やパラメータを推測しないでください。API の事実と未検証情報：references/higgsfield-api.md
ルール
- 料金発生はその価格に対する承諾の後でのみ。 常に最初に
estimateを実行し、表示されたドル額（ASK:行）を質問として提示し、ユーザーが承諾した場合のみsubmit --confirm <estimate id>を実行します。新しい価格（見積もりが30分以上経過した、またはsubmitが価格変更を通知した場合）は、新たな質問が必要です。 - ユーザーの映像は同意なしにコンピュータから送信されません。 ユーザーの動画のクリップまたはフレームは
submit時に Higgsfield にアップロードされます。その旨を価格と同じ質問で伝えてください。 - チャットでキーを決して尋ねないでください。 キーがない場合：ユーザー自身のターミナルで
python3 "$G" setkeyを実行するよう指示してください（キー ID とシークレットを console.higgsfield.ai からid:secretの形式で入力するよう求められ、入力内容は非表示になります）。 profile.jsonのgen_budget_usdが月間使用額の上限です。submitはこれを超えると拒否します。残高を伝えて停止してください。- 失敗および
nsfwの結果は課金されません。失敗した場合はその旨を伝え、プロンプトの変更を提案してください。
手順
- 内容と場所の特定。 ユーザーの発言と編集内容（
edits/<name>/）から：種類（モーショントランスファー、文章からの Bロール、静止画の動画化、カード用静止画）、対象となるタイムライン上の秒数（words.jsonのトランスクリプトから）、モーショントランスファーの場合はユーザーの動画の範囲（4 秒以上、最大 30 秒）を特定します。モデルはpython3 "$G" models --kind <kind>で選択します。 - プロンプトの作成。 ユーザーの発言から、主題、設定、カメラ、照明を40語以内で自分自身で記述してください。Bロールは動画の形式に合わせます（縦型編集では縦型のショット）。モーショントランスファーには 1～8 枚の参照画像（
--image、ファイルまたは URL）が必要です。動作を移植するスタイルです。 - 見積もり。
python3 "$G" estimate edits/<name> --model <id> --prompt "<prompt>" [--video raw.mp4 --from 12.0 --to 18.0] \ [--image ref.png] [--param duration=5] --at <timeline seconds>generated/inputs/に保存され、アップロードせずにリクエストの見積もりが行われ、見積もり ID、usd、credits、over_budget、およびASK:行が出力されます。 - 質問。 1つの質問ボックスで：
ASK:行を質問文（価格、モデル、アップロード内容）とし、選択肢は「はい、生成します（推奨）」/「プロンプトを変更する」/「いいえ」とします。予算超過の場合はその旨を伝えて停止します。 - 承諾後のみ送信：
python3 "$G" submit edits/<name> --confirm <estimate id>。これにより入力がアップロードされ、再見積もりが行われ、ジョブ ID が出力されます。 - バックグラウンド待機（生成には数分かかります）：
python3 "$G" wait edits/<name> <job>。指数バックオフでポーリングし、結果をedits/<name>/generated/にダウンロードし、プローブし、タイムラインの「Generated」トラックに--atで Claude の変更として追加します（project.py apply経由。プロジェクト文書がまだない場合はgenerated/<job>.ops.jsonに書き込み、出力します）。status/listで進捗表示、cancelはキュー中のみ有効です。 - 引き継ぎ。 何が追加されたか、場所、費用を伝えてください。ユーザーは他のクリップ同様に移動、トリミング、削除できます。生成結果の見た目の修正指示は
tasteに追加されます。
コマンドが停止した場合
| メッセージ | 対応 |
|---|---|
No Higgsfield key | ユーザー自身のターミナルで python3 "$G" setkey を実行するよう指示し、再開する |
needs at least 4 s | --from/--to を広げるか、テキストまたは画像モデルを選択する |
over this month's generation budget | 残高を伝える。gen_budget_usd を引き上げ可能 |
the price is $X, not $Y | 新しい価格で再質問し、新しく出力された ID で submit --confirm を実行する |
Maximum number of concurrent requests | クライアントは既にリトライ済み。実行中のジョブが完了するのを待ってから送信する |
ended failed / ended nsfw | 課金されず。変更したプロンプト（新しい見積もりと質問）を提案する |
ファイル
lib/ai_editor/gen/gen.py：上記のコマンド、demo自己チェック（偽の Higgsfield、ネットワーク不要）lib/ai_editor/gen/higgsfield.py：API クライアント。base.py：プロバイダーインターフェースとカタログlib/ai_editor/gen/jobs.py：edits/<name>/generated/jobs.jsonと月間使用額references/higgsfield-api.md：API の文書化（ソース付き）