Communitygithub.com

0xsline/openchatcut

用于验证对OpenChatCut项目的编辑是否已正确反映在编辑器中。

openchatcut 是什么?

该技能定义了在OpenChatCut项目中验证AI Agent编辑结果的标准化流程。它提供了从L0到L2的递进式验证等级:L0涵盖静态检查(如TypeScript编译、测试和构建),L1则要求通过真实Agent运行编辑器并结合结构化和可视化证据,L2需要打包的桌面应用完成用户场景,并在自动化不足时进行人工审查。运行时行为的变更必须通过L0和L1验证,发布或桌面专属变更还需通过L2。技能文档详细说明了如何结合使用`read_project`读取项目结构(资源、轨道、项目、帧放置和时间线时长)和`view_timeline_frames`获取渲染后的时间线截图(支持修剪、图层、字幕、特效、标记、占位符、裁剪、转场和布局验证)作为核心证据。对于原始源帧检查,推荐使用`view_asset_frames`,它会自动使用ffmpeg缩略图接触片快速路径,而且没有单独的`get_contact_sheet`工具。技能还强调,在判断编辑器是否反映了修改时,不应仅依赖命令行JSON响应,而应尽可能使用编辑器URL或视觉证据。此外,每次L1运行后都必须检查完整的聊天记录,包括展开失败或警告行记录错误、检查中断的轮次和重试、比对最新的`read_project`结果与可见时间线,并检查返回的时间线帧而非信任助手总结。该技能支持在本地媒体上传场景下,若资源字节尚不可用,则`view_asset_frames`仍可工作,但时间线证明可能受阻。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/verification

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

验证

使用能证明请求结果的最低验证等级:

等级所需证据
L0静态检查,例如聚焦的验证脚本、npx tsc --noEmit、测试和构建。
L1针对 localhost:5199 编辑器的真实 Agent 运行,随后提供结构性和渲染后的证据。
L2打包的桌面应用完成用户场景,包括在自动化不足时进行人工视觉审查。

运行时行为变更需要 L0 + L1。发布和仅桌面端的更改在打包应用是测试行为时也需要 L2。

优先使用两个信号:

  1. read_project 用于查看结构:资源、轨道、项目、帧放置、时间线时长。
  2. 用于在精确帧上渲染证据的视觉捕获路径。

使用 view_timeline_frames 获取合成时间线证明。这会验证已编辑的 OpenChatCut 时间线:修剪、图层、字幕、特效、标记、占位符、裁剪、转场和布局。

对于原始源资源帧检查,根据字节所在位置选择最经济的路径:

  • 此构建中的 Agent 无本地文件系统访问权限;所有源字节位于项目媒体存储(/media/uploads/)中。使用 view_asset_frames 并传入项目资源 ID —— 服务器会自动采用 ffmpeg 联系表快速路径,因此它已经是代价最低的源帧路径。
  • view_timeline_frames 渲染合成时间线(编辑器真实性检查);view_asset_frames 采样原始源帧。根据您要验证的内容进行选择。
  • 此构建中没有单独的 get_contact_sheet 工具 —— 联系表正是 view_asset_frames / view_timeline_frames 已经返回的内容。

仅将本地/远程源帧工件用于源理解、时刻选择和粗略修剪决策,而不是作为编辑后的输出或时间线证明。

对于仅本地或上传中的媒体,合成时间线证明可能被阻塞,直到资源有可供渲染器使用的字节。只要资源的字节在磁盘上(/media/uploads/),view_asset_frames 源帧检查仍然有效。

如果两个视觉证明路径都被阻塞,请让用户直接检查 OpenChatCut 编辑器,并明确记录阻塞原因。

有用的检查:

  • 导入后:read_project({ "view": "assets", "assetId": "<前缀>" })
  • 移动/修剪后:read_project({ "view": "timeline" })
  • 在任何时间线媒体上添加视觉叠加或动态图形后:view_timeline_frames({ "frames": [30, 45, 75] }),然后查看返回的帧。
  • 对于用户请求的源选择或视觉时刻选取:使用 view_asset_frames 采样静态图像并进行检查。仅用于选择源文件、时刻和粗略修剪。将可见编辑构建为 OpenChatCut 时间线项目。不要将原始源检查视为时间线验证或允许在其他地方生成编辑后的视频。
  • 对于源帧检查:在 read_project({"view":"assets"}) 确认资源 ID/类型后,调用 view_asset_frames({"assetId":"...","sourceTimesMs":[...]})。优先于要求用户重新附加文件。
  • 对于仅本地的视觉验证:在依赖连接器视觉证明之前,上传/注册云可读媒体。
  • 对于无源验证:确认工具清单公开了您使用的参数,然后在跟踪日志中记录可见证明。

当谈论秒时,从 read_project 验证 fps 或使用内部解析 fps 的适配器工具。

当报告时间线项目位置时,仅使用最新的 read_project 结构来获取轨道别名、项目 ID、起点、持续时间和资源 ID。不要报告计划/默认轨道或工具调用意图作为已验证的放置。

当用户询问编辑器是否反映了结果时,不要仅将命令行 JSON 响应视为充分证据。在实际可行时使用编辑器 URL 或视觉证据。

真实 Agent 聊天记录检查

每次 L1 Agent 运行后,在报告成功之前检查完整的聊天记录:

  1. 读取最终的助手响应以及由该运行创建的每一个工具行。
  2. 展开失败或警告行并记录确切的错误。
  3. 检查是否有中断的轮次、重复的重试、过时的提议、未完成的作业以及最终响应错误地描述为成功的工具结果。
  4. 将最新的 read_project 结果与可见的时间线进行比对。
  5. 对于视觉编辑,检查返回的时间线帧,而不是信任助手摘要。

一个时间线看起来正确但存在未报告的工具错误的运行不是干净的通过。修复原因或明确报告剩余的错误。

如果验证失败,在更改工具之前对差距进行分类:

  • 工具描述或模式不够充分
  • 技能指令缺少了一个步骤
  • read_project 未暴露足够的状态
  • 编辑器授权未完成
  • 媒体/转录管道失败
  • 云渲染/编辑器观察被阻塞

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

0xsline/openchatcut

Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.

0xsline/openchatcut

Use when acquiring or importing media into a OpenChatCut project asset library for video editing or creation, including local/attached videos, user-provided paths, public media URLs, web video/audio/image assets, upload fallback decisions, and deciding between import_media, download_media, or manual user action.

0xsline/openchatcut

Use when a OpenChatCut video editing or creation workflow needs export, render, download, share, final delivery, subtitle-file export, render choice, local-only asset handling, or export fallback explanation.

0xsline/openchatcut

AI image generation via Fal.ai, gpt-image-2, nano-banana, MiniMax image-01, and xAI Grok Imagine. Use when the user wants to generate or create an image / picture / still.

0xsline/openchatcut

Use when a OpenChatCut tool call fails or returns an unexpected shape.

0xsline/openchatcut

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

0xsline/openchatcut

OpenChatCut product knowledge — UI layout, editor features, and how generation providers are configured. Use when the user asks about the product interface, how to use a feature, where to find something, or needs GUI guidance for something the agent cannot do directly. Also use as fallback when a task fails and the user needs to complete it manually in the UI. NOT for live project-state queries ("where are my folders?", "what's on my timeline?", "where is clip X?") — those are answered by `read_project`, not by this skill.

0xsline/openchatcut

AI shader generator for WebGL video effects, transitions, masks, and color grading (LUT / 调色 / 电影感 / film look). Use when the user wants a video effect (滤镜 / 特效), a transition (转场 / crossfade / wipe / cube / 3d), a mask (蒙版 / 遮罩 / reveal), a zoom / push-in (推近 / 推镜头), or a color grade — try the built-in effects (zoom, builtin LUTs) before generating a new shader.

0xsline/openchatcut

AI video generation via Fal.ai, Seedance 2.0, Kling, MiniMax Hailuo, xAI Grok Imagine, and OFox. Use when the user wants to generate a video clip — text-to-video, image-to-video, first/last-frame transitions, reference-guided generation, multi-shot, or generatively editing / extending an existing clip.

0xsline/openchatcut

Text-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.

0xsline/openchatcut

Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.

相关技能