生成
路径：${CLAUDE_SKILL_DIR} 指包含此 SKILL.md 的文件夹，${CLAUDE_SKILL_DIR}/../.. 指其上层两级的编辑器文件夹（本仓库的 .claude/）。
所有向用户的提问都必须放在提问框中：调用 AskUserQuestion 工具（提供 2-4 个选项，推荐选项置顶）。仅当 Agent 没有该工具时，以文本形式用编号提问。
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（它会要求输入来自 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 <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 <timeline seconds>generated/inputs/，在不上传任何内容的情况下对请求进行报价，并打印出估算 ID、usd、credits、over_budget以及ASK:行。 - 询问用户。 一个提问框：将
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 及来源。