agentleFS
badmoonrbadmoonr/loopilot/skills/video-script-generator/SKILL.md

video-script-generator

Skill1 starsChanged 27 days agoApache-2.0View on GitHub

所有新视频生成及视频提示词请求的统一入口,包括直接创作、商品原创、视频复刻、女装模板批量和补生成。由本作品干净创意作者根据实际素材完整撰写叙事 Prompt,主 Agent 选择渠道和账号,再委托 Jimeng、Higgsfield、Ark 等现有执行器;也处理原有脚本、口播及候选任务。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

先读取相邻 创意作者交接。新脚本/口播/最终视频 Prompt 由本作品干净作者连贯成稿;当前已是作者时不再派发。主会话提供完整创作要求、原始素材和期望结果;作者只交成稿,主会话负责验收、选择渠道账号并登记/执行。

任务方案与交付

主会话验收独立脚本/Prompt 使用相邻 ecommerce-operations/templates/task-checklists/video-script.md,在创作任务内部则沿用该任务相关项。实际参考输入可携带多个 roles、reference_ids、covers_shot_ids 和来源 bindings;按最终去重列表的 index/marker 核对正文,不能把一个共享图解释成多张逐镜图。换图或顺序变化先按当前实际素材复核,清单勾选不替代观看输入和最终产物。

主 Agent 在本阶段前读取相邻 ecommerce-operations/references/task-execution.md,沿用本任务最新有效方案和适用偏好,按真实结果交付并记录成功操作。已在同一任务读取时直接复用;不反向重启总控或重复业务动作。Agent 主导顺序、分支与恢复,本 Skill 返回实际结果和正式恢复线索。该参考暂不可读时说明缺口并继续当前可执行工作,不新增文档或格式硬门槛。

Video Script Generator

本 Skill 是视频生成阶段的统一入口,不是后台模型服务。本作品作者读取本文件的写作规则,理解本次要求与实际素材,自主成稿或复用已有合适正文,只交付正文;不要求分析、候选比较、自检或验收报告。后续路由、登记和执行由主会话处理。调用 Python 函数不等于 Agent 已读规则。

写作规则

  1. 写看到的过程:以主体、动作、反应和前后变化为中心,像描述一段可拍摄的故事,不逐项翻译 Shot 字段、审核要求或字典。
  2. 主体和运动明确:谁在什么位置做什么、作用于什么、随后如何反应。按画面需要补充视线、重心、速度、停顿或镜头跟随,不靠“高级感、生动自然”代替画面。
  3. 先看实际采用的图,再确定素材职责。参考视频按需读取正式理解结果或片段;说明素材提供身份、商品外观、场景、动作、运镜或特效中的哪些信息。编号对应真实上传顺序,不能用文件名或尚未采用的草图冒充已观察成品。
  4. 尊重明确要求与已确认创意:保留其主体、核心动作、事件顺序、商品关系和结果;主 Agent 未经确认的动作建议不作为必须继承的创意,已被反馈否定的内容交原作者修订。允许补充动作连续性、自然反应、光线、环境和镜头;不带入参考商品的无依据事实。
  5. 正向描述优先。必要商品、声音、文字边界由 Agent 按任务简洁表达,不拼接历史错误清单,不设负向词数量/比例。
  6. 节奏服从画面和时长。允许静物、缓慢特写和留白;不强制 UGC、跳切、每段起承转合或剧烈运动。仅在事件时间或切换确有需要时写时间段。
  7. 正文与执行参数分开。渠道、账号、模型、比例、分辨率、时长通过原生参数传递,必要音画意图自然入文;不混入路径、审批、预算、Schema、空状态或 Python 字典。
  8. Agent 完整成稿,程序不代写。代码不补句、不改风格、不追加负向列表或模板兜底。既有合适正文直接复用;用户明确要求逐字提交时原样保留并记录人工来源。

这些是结果表达指导,不规定构思步骤、候选数量、固定故事公式或镜头数;不增加 Prompt 自检、评分、关键词配额或逐段人工审批。平台实际输入回读属于提交事实核对,不是创意评审。

输入与交接

  • 直接请求:使用用户意图、素材及参数即可,不伪造商品或复刻合同。仅要求 Prompt 时交付正文即结束,不提交媒体生成。
  • 创作/复刻:上游仍由 creative-runner 负责当前方案、实际采用图、声音和后制。作者有未定创意时自主构思;已有确认稿按本次要求复用或返修,执行阶段不擅改故事和口播。
  • 原生请求:保留已有 prompt、素材顺序、技术参数、授权/预算/任务绑定。只允许明确的机械素材 marker 映射及传输转义,保存成稿原文和实际提交文本。
  • 已成稿且绑定明确的原生请求直接委托执行,不循环回跳成稿;查询、下载、submitted/unknown 恢复始终沿原渠道/账号/模型,不重新写 Prompt 或再次提交。
  • 纯剪辑/历史混剪无需新视频成稿;仅补生成分支进入本 Skill。其它项目和第三方内部实现不声称自动受控。

渠道和账号单点维护

静态渠道目录:config/video-generation-channels.yaml。只维护渠道标识、既有执行 Skill 和配置来源,不复制动态能力、价格、账户清单、密钥或 Cookie。

选择顺序:本次明确指定 > 业务账号已配置默认 > 已配置全局默认。只合并兼容渠道/账号的字段;无明确默认时询问,不默认为即梦、不选首个启用账号。显式账号改变时重新解析该账号的绑定,不继承旧账号会话或凭据引用。

账号事实仍来自:

  • 即梦:既有 queue profile 的 jimeng_accounts 和明确的 defaults.jimeng_account_key。
  • 业务账号默认:当前创作 Profile 的 video_generation;全局默认:既有 merchant.defaults.video_generation。
  • Higgsfield:创作路由及实际浏览器会话;Ark:原 Provider Profile 和其业务账号作用域。
  • 登录、余额、忙碌:对应渠道现有只读能力;配置 enabled 不代表实时可提交。无法读取就说明未知。

用户可通过本 Skill 查询或提出账号/默认配置维护;只有明确授权修改时才最小修改既有权威配置、备份并回读。不另建账户库,不把凭据写到本 Skill 或日志。 暂时忙碌保留原队列。仅在已有明确授权候选范围内换渠道/账号/模型,不扩大费用;submitted/unknown 只查原绑定,绝不作为替换候选。

当前 Agent 如何执行

  1. 读取本次意图、当前有效方案和实际素材;已提供完整合适正文可以复用。
  2. 解析上述明确路由,按渠道 Skill 获取实际参数与素材引用能力;由本作品作者按写作规则完成整段正文。
  3. 用原 producer 登记正文和引用。缺正文返回的 needs_model_action 是交接待办:主 Agent 将实际资料交回本作品作者补写,再重入,不把它当作人工批准关卡,也不补代码模板。
  4. 按已有费用/外写授权委托渠道,回读真实提交与生成结果,返回原调用方。成稿成功、排队、提交、生成完成、交付分别报告。

缺来源标签、新版 Schema、版本、可恢复路径/hash 或风格词均不是成稿许可证。Agent 可补读、适配或调用原入口重建;遇到真实身份/权利冲突、未授权费用、客观缺素材或不明提交事实,只暂停受影响动作并说明事实。不手改生产终态、receipt、ledger 或 lineage。

本地薄工具与恢复入口

scripts/video_generation_request.py 只整理上下文、解析明确配置、投影完整正文;无模型/媒体调用、队列或并行账本。

python3 scripts/video_generation_request.py prepare --request /abs/request.json
python3 scripts/video_generation_request.py project --request /abs/request.json --prompt-file /abs/prompt.txt --output /abs/projected.json
python3 scripts/video_generation_request.py route --request /abs/route-input.json
python3 scripts/video_generation_request.py channels

输入可直接使用已有 prompt / provider_prompt / agent_prompt / model_generated_prompt;reference_marker_map 仅在明确提供映射时使用。来源与 hash 是追溯信息,不作为运行门槛。

原 producer 保持:

  • 原创:creative-runner/scripts/product_original_pipeline.py video-tasks --output-dir /abs/run --agent-prompts /abs/segment-to-prompt.json。
  • 复刻:creative-runner/scripts/video_replication_pipeline.py build-segment-task-payloads 原参数加 --agent-prompts /abs/segment-to-prompt.json。
  • 女装/单商品/批量:creative-runner/scripts/single_product_pipeline.py register-video-prompt --product-dir /abs/product --prompt-file /abs/prompt.txt;再恢复原 run/worker。
  • 旧 build_video_prompt.py、build_video_replication_prompt.py 函数仅兼容原字段与技术元数据,停止从 actions/Shots 编写最终正文。

逐段映射值可以是完整字符串,或带 prompt、可选来源及 marker 映射的对象。恢复保留已写段落,不重新生成媒体。旧冻结、排队、在途请求不因升级改写;显式新 revision 通过原生最新方案入口继续。

条件参考

  • 即梦素材引用细节:references/jimeng-prompt-rules.md。
  • 已有候选、口播、混剪/字幕能力:仅对应任务读取 references/existing-script-capabilities.md,以及其原合同。它们不成为所有视频任务的前置条件。
  • 用户偏好:仅从任务/商家配置或显式 LOOPILOT_STATE_ROOT 解析既有 <state_root>/preferences/user-preferences.md,读取 preference-policy:learning、索引和 preference-section:common、preference-section:creative、preference-section:narration;缺失继续,不初始化第二份文档。仅作软默认,本次任务优先。由 creative-runner 调用时只返回应用/修改证据,由外层唯一写回;直接收到验收时遵守文档元规则,不跨商品学习事实。

共享商品知识(LP-139)

商品图片/视频策划前按共享商品事实与卖点准备上下文并冻结到原任务;跨店只共用有据事实,保持本店商品/SKU/价格和账号素材权限。已有在途任务保留原采用版本;缺口沿原资料恢复,不触发媒体或平台写入。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.