橙星梦工厂 Agent Skill

橙星梦工厂是一个 AI 驱动的漫剧制作平台。通过 API 创建项目、提交剧本、提取角色、生成分镜、配置成片并最终合成视频。

内测提示

当前您正在使用的是 Funai-skill 内测版。 Agent 在与用户交互时，应明确告知当前处于内测阶段。

重要结论

真实后端不是“只看 workflow.currentStep 的线性流程”，而是：

• 一层是项目级步骤：workflow.currentStep
• 一层是章节级隐藏任务：comicPreset.data.chapters[] 中的 sceneCaptionsTaskStatus、dialogTaskStatus、sceneTaskStatus

Agent 如果只看 currentStep 就继续调用下一步，非常容易报错。

Skill 更新约束（创建类操作前必须执行）

本地机器可读版本文件：VERSION

说明：对外文案不再重复写死版本号；实际版本以本地 VERSION 与远端 setup 元数据中的 latest_version / minimum_required_version 为准。

每当 Agent 准备调用本 Skill 执行任何会创建、推进、修改平台任务的操作前，必须先访问固定更新入口：

https://neirong.funshion.net/skills/setup-skill.md

至少检查以下字段：

• latest_version
• minimum_required_version
• force_update
• skill_package_url

执行规则：

1. 如果本地尚未安装本 Skill，必须先自动安装。
2. 如果远端要求强制更新，或本地版本低于 minimum_required_version，必须先自动更新。
3. 版本检查完成后，才能继续执行创建项目、提交剧本、推进步骤、生图、生视频、回退、合成等操作。

快速配置

1. 获取 Token

引导用户访问 https://ai.fun.tv/#/openclaw 并登录，获取 Token 后由 Agent 代为写入配置文件。

2. 配置 Token

cp config/.env.example config/.env
# 编辑 config/.env
# AIFUN_TOKEN=...

3. 验证配置

./scripts/api-client.sh setup-check
./scripts/api-client.sh check

4. 运行完整自检示例

./examples/create-comic.sh

示例脚本是自检脚本，会使用 select-options 返回的实时默认值自动创建测试项目。

面向真实用户的 Agent 交互中，仍然必须先读取实时可选项；其中 aspect / style 必须展示给用户并让用户选择，generateType / scriptType 可按当前默认值静默使用，model / videoModel 在用户未指定时可继续使用实时默认值。

另外，示例脚本为了验证整条链路，会在自检场景下先提交剧本再展示“确认点”；这不代表真实用户交互可以跳过“先确认再继续”的节奏要求。

Agent 必须遵守的执行规则

0. 默认模式静默使用，不要主动向用户解释

除非用户明确提出要切换模式，否则 Agent 应直接使用平台默认模式：

• generateType = 1（文生图）
• scriptType = 解说漫模式（以 select-options 返回的默认剧本模式为准）

但这条“静默默认”只适用于模式层级，不适用于项目视觉配置。

创建项目时，以下两个字段不能静默默认，必须让用户明确选择：

• aspect（画面比例）
• style（风格）

重要：

• 这是 Agent 的内部默认决策，不要主动把“现在默认使用文生图 / 解说漫模式”当成一个需要告诉用户的配置项。
• 只有当用户明确要求切换到其他模式时，才需要说明并调整。
• 即使静默使用默认模式，底层仍然必须先调 select-options，并使用当次接口返回的默认值，而不是写死常量。
• aspect / style 不能因为接口返回了 isDefault 就直接替用户决定，必须向用户展示可选项并让用户确认。

1. 创建项目前必须先调 select-options

POST /service/workflow/project/story/select-options
{"appCode":"ai-story","generateType":"1"}

规则：

• 必须使用接口返回的 ratios、generateTypes、models、videoModels、styles、scriptTypes
• 禁止硬编码风格、模型、比例、剧本类型
• isDefault 是请求相关的，不要把历史默认值写死在代码或文档里
• 如果用户没有明确要求切换模式，则直接静默使用当次接口返回的默认 generateType / scriptType
• 但 aspect / style 必须向用户展示并让用户选择，不能静默默认
• model / videoModel 若用户没有额外要求，可以继续使用 select-options 返回的当前默认值
• 面向用户交互时，不需要主动把“文生图 / 解说漫模式”当作默认项拿出来解释；但必须明确让用户选择 aspect / style

2. 解说剧 / 解说漫模式下，AI 代写剧本必须写成旁白叙述式小说体

如果用户让 AI 帮忙写剧本，而当前走的是解说剧 / 解说漫模式，Agent 必须把剧本写成旁白叙述式的小说 / 故事正文，而不是分镜脚本。

必须符合：

• 连续叙事
• 以旁白持续讲述故事推进为主
• 可以穿插少量自然对白，但整体仍应是讲述型正文
• 适合后续交给平台自动拆分角色、分镜与解说

禁止出现这类写法：

• 镜头1 / 镜头2
• 旁白：... 这种显式台本标签
• 林舟说：...
• 【音效：脚步声】 / 砰！ / 咚—— 这类音效描述
• 舞台说明式条目
• 分镜表 / 台本格式

正确风格示意：

清晨，城市公园的林荫道上，年轻人林舟正在慢跑。阳光穿过树叶，在青石板路上投下斑驳的金色光影。