生成
路徑：${CLAUDE_SKILL_DIR} 指的是包含此 SKILL.md 的資料夾，${CLAUDE_SKILL_DIR}/../.. 則是指編輯器資料夾（此儲存庫兩層上層的 .claude/）。
每個向使用者提出的問題都應放在問題框中：呼叫 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 <估算 ID>。如果價格已變更（估算超過 30 分鐘，或submit顯示價格已變更），則需重新提問。 - 使用者的素材只有在獲得同意後才能離開其電腦。 使用者的影片片段或影格會在
submit時上傳至 Higgsfield。請在與價格相同的問題中一併告知此事。 - 切勿在聊天中要求金鑰。 沒有金鑰：請告知使用者在他們自己的終端機中執行
python3 "$G" setkey（此指令會要求輸入來自 console.higgsfield.ai 的金鑰 ID 與密碼，並以id:secret格式串接，且會隱藏輸入內容）。 profile.json中的gen_budget_usd會限制每月花費上限；submit會拒絕超出預算的請求。請告知剩餘額度並停止。- 失敗及判定為
nsfw的結果不會被計費。若發生此情況，請告知使用者，並提議修改提示詞。
步驟
- 確認內容與位置。 根據使用者的話語及編輯專案（
edits/<name>/）：類型（動作轉移、文字生成 B-roll、靜態圖片動起來、為卡片生成靜態圖像）、它涵蓋的時間點（時間軸上的秒數，從words.json中的逐字稿得知），以及動作轉移所需的使用者影片片段（4 秒或更長；模型最多保留 30 秒）。使用python3 "$G" models --kind <類型>選擇模型。 - 撰寫提示詞。 根據正在說出的台詞自行撰寫：主體、場景、攝影機、光線，字數限制在 40 字以內。B-roll 應符合影片的格式（直式編輯獲得直式感覺的鏡頭）。動作轉移需要 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 <時間軸秒數>generated/inputs/中，在不上傳任何內容的情況下估算價格，並列印出估算 ID、usd、credits、over_budget以及一個ASK:行。 - 提問。 一個問題框：將
ASK:行作為問題（價格、模型以及會上傳的內容），選項為「是的，生成它（建議）」/「修改提示詞」/「不要」。如果超出預算：請改為告知此事並停止。 - 僅在同意後才提交：
python3 "$G" submit edits/<name> --confirm <估算 ID>。它會上傳輸入檔案，依據上傳內容重新估算價格，提交任務並列印出任務 ID。 - 在背景等待（生成需要數分鐘）：
python3 "$G" wait edits/<name> <任務>。它會使用退避機制輪詢，將結果下載到edits/<name>/generated/中，對其進行探測，並將其作為 Claude 的變更（透過project.py apply執行；若尚無專案文件，則寫入generated/<job>.ops.json並列印出來）新增至時間軸的Generated軌道--at位置。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（附有來源）。