使用AI 开发与发布 OGRAF 动画
支持任意 AI Agent 开发 ograf 动画,比如 Codex、Claude Code、WorkBuddy、Qoder 等
在 AI Agent 中安装 ograf-creator-skill
选择你使用的 AI Agent,打开用于动画创作的本地工作目录。下面提供 Codex 和 WorkBuddy 两个安装示例,复制对应指令发送即可。
Codex
在 Codex 对话中发送以下指令,使用 skill-installer 从 GitHub 安装。
$skill-installer 安装 https://github.com/minghe36/ograf-creator-skill安装完成后,直接说“使用 ograf-creator-skill 创建动画”。如果技能未出现,重启 Codex 后再检查。
Codex 官方文档WorkBuddy
在 WorkBuddy 中选择本地工作目录,新建任务并发送以下指令。
请安装 Skill:https://github.com/minghe36/ograf-creator-skill安装完成后,在任务中说“使用 ograf-creator-skill 创建动画”,让 WorkBuddy 确认已读取对应 SKILL.md。
WorkBuddy 官方文档GitHub 无法访问?
让 AI Agent 从 CDN 下载 ZIP,解压后安装 Skill。Codex 和 WorkBuddy 都可以使用下面的指令。
请从 https://cdn.haoai.pro/assets/ograf-creator-skill.zip 下载并解压,然后安装 ograf-creator-skill。如果已下载到本地,可将 ograf-creator-skill 目录路径提供给 AI Agent,请它完成安装。登录与上传需要使用包含 scripts/ograf_auth.py 的完整版本。
创建第一个动画
在 Codex 中打开用于存放动画的本地文件夹。描述名称、用途、视觉与动效,并明确横屏和竖屏支持;可以同时附上参考图片。创建、预览和校验都在本地完成,不需要登录 ograf.app。
使用 ograf-creator-skill 创建一个简单的标题动画:文字“你好,OGRAF”居中,白色文字、透明背景,缓慢淡入后停留,总时长 3 秒。支持 1920×1080 横屏,可修改标题、颜色和字号。
创建后打开本地预览,先不上传。- Codex 会在工作目录中创建组件文件。名称、描述与横竖屏支持应与你的需求一致。
- 先看实际预览,再检查可编辑参数是否能即时改变画面。
用 AI 迭代开发动画
在同一个 Codex 对话中继续提出修改。说清楚改哪个元素、目标效果和需要保留的内容;参考图、颜色值与时长都可以直接提供。
把刚才的标题改成“我的第一个动画”,文字颜色改为紫色,淡入时间改为 1 秒。修改后重新预览。- 一次集中修改一组问题,更容易判断效果。需要时让 Codex提供截图或打开本地预览。
- 参数、动效和画面都确认后,再让 Codex校验并打包。预览通过不等于已经发布。
登录 ograf.app
创建和迭代都只在本地进行,不需要账号。只有上传或发布作品时才需要 ograf.app 账号:在 Codex 中发送下面的指令,按打开的浏览器页面完成 HaoAI 登录。Codex 的登录与 ograf.app 的登录是两件事。
使用 OGRAF Creator Skill 登录 ograf.app。请运行 Skill 中的 scripts/ograf_auth.py login,打开登录页面,并在完成后检查登录状态。- 浏览器登录完成后,返回 Codex,确认登录成功。Skill 会将上传凭据保存在本地,后续上传、同步和修改都可以复用。
- 如果需要确认当前账号是否已登录,让 Codex 运行 scripts/ograf_auth.py status;凭据失效或上传返回 401 时重新登录即可。
打包并发布到社区
确认动画满意后,在 Codex 中明确要求上传并发布。上传会先创建工作区草稿;还需要完成社区发布,作品才会出现在公开页面。
预览已确认。请使用 OGRAF Creator Skill 校验并打包当前动画,然后上传到我的 ograf.app 工作区并发布到社区。
保留已确认的名称、描述、可编辑参数和横竖屏支持。检查上传及发布的返回结果,完成后给我公开作品链接;如果只上传成草稿,请说明尚未发布,并继续完成发布。- 上传限制:压缩包不超过 500 KB,JS 单文件不超过 500 KB,图片单文件不超过 1 MB,最多 200 个文件,解压总量不超过 2 MB。禁止视频;请使用包内资源,脚本扫描会拒绝动态执行代码、敏感 API 和外部资源。
- 首次上传按提示登录;已登录时复用本地凭据。若上传失败,保留本地组件和文件包,修复后重试。
- 打开返回的公开链接,核对预览、标题、配置和下载。之后修改作品时,请让 Codex更新已有作品,避免重复创建。