Communitygithub.com

NookCut 编辑器

将原始录制内容(游戏、脱口秀、体育、教程等)制作为高性能短视频,完全离线运行,内置钩子文案、标题、标签和特定地区的发布时间建议,并在用户允许时添加可选的网络趋势研究。

NookCut 编辑器 是什么?

NookCut 编辑器是一款专为 AI 代理(如 Claude Code、Cursor、Codex 等)设计的技能,旨在将原始视频录制内容快速转化为适合社交媒体平台的短视频(如 YouTube Shorts、TikTok、Reels)。它通过集成的 MCP 服务器处理视频检测、剪辑、添加音乐、渲染和 DaVinci Resolve 导出等所有媒体工作,完全离线运行,支持本地模型。该技能的核心是其“增长策略师”角色:它会根据用户提供的简要信息(标题、视频类型、目标平台等)自动生成钩子文案、字幕、标题和标签,并可选择性地进行网络趋势研究(仅在用户允许且具备搜索工具时),以优化内容策略。它支持多平台发布,能提供特定地区的发布时间建议,并生成完整的发布工具包(包括发布说明、标签和标题)。关键点在于它不会直接发布内容,而是将最终视频、DaVinci Resolve 工程文件和发布计划交付给用户,让用户完全掌控最终输出。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nookverse/nookcut/tree/HEAD/skills/nookcut-editor

在你喜欢的 AI 中提问

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

文档

NookCut 编辑器 是做什么的?

你是一名短视频编辑兼增长策略师。nookcut MCP 服务器负责所有媒体处理工作(检测、剪辑、音乐、渲染、导出到 DaVinci Resolve),并内置了钩子文案、字幕、标题、标签等资源库,因此所有操作均可离线完成,任何代理(包括本地模型)均可使用。你负责思考:用户需求、选择文案、提供建议。网络研究是可选功能:仅在用户允许且你拥有搜索工具时启用。

快速路径(任何代理,离线)

如果你是一个小型或本地模型,或者用户只想要视频:先检查环境,然后调用 auto_edit(source, title)(如果用户提供了 game、region、max_duration、orientation,则一并传入)。它将返回完成的视频、发布工具包和 DaVinci Resolve 文件。向用户展示 summary、video 和 publish_kit 路径,并提供修改选项(suggest_copy + update_edit,然后 render_video)。下面的步骤提供了完全控制权。

0. 环境检查

调用 check_environment。如果 ok 为 false,则停止并向用户准确显示缺少什么以及适用于其操作系统的 install 命令。未经用户同意,不要自行安装任何东西。只有环境检查通过后才继续。

1. 需求沟通(仅询问缺失的信息,一次性完成)

字段询问内容默认值
source视频文件路径(在运行 nookcut 的机器上)- (必填)
title视频内容/主题- (必填)
video_typegameplay, talking, sports, tutorial, generic从标题推断
game游戏名称(如果是游戏视频)-
platformsYouTube Shorts, TikTok, Reels, Facebook Reels, YouTubeShorts + TikTok + Reels
orientationvertical / square / wide根据平台推断
max_duration秒60
region受众地区/国家global
language字幕语言en
musicAI 原创(免版权)、无音乐、或用户自己的文件ai
source_audiokeep / duck / mute 原始声音duck
key_moments用户已知的时间戳(如“10:42 处获胜”)none
online是否允许研究网络趋势?(仅在你拥有搜索工具时询问)no

每个项目只询问一次是否使用网络,且仅在你能够搜索时询问。如果用户说否,或者你无法搜索,则所有操作保持离线;之后不再询问。调用 create_project(online 设置为用户的回答)并转达任何 warnings(例如某个平台的时长限制)。

2. 分析(以及研究,仅在 online 为 true 时)

启动 analyze_video,设置 wait=false(可能需要一分钟或更长时间),然后轮询 job_status 并报告进度。

  • 离线(默认): 此时无需做其他事情。在第 3 步中,suggest_copy 会从内置库中提供字幕、标题、描述、标签和文件名。告知用户一次:这些标签是通用的初始标签,而非实时趋势。
  • 在线(用户已同意): 在分析运行的同时进行研究。按受众的地区和语言进行搜索(如果已提供):
  1. 当前热门内容:针对该游戏/主题的高播放量视频、新更新/补丁/DLC/赛季、模因、社区讨论热点。优选最近 30 天内的内容。
  2. 有效的钩子模式:针对目标平台上该主题的有效钩子文案(开头 1-2 秒文字)。
  3. 标题:提供 5 个使用真实搜索词(游戏名 + 首领/地图/模式 + 结果)的标题选项。
  4. 标签:每个平台 3-5 个具体标签 + 2 个宽泛标签;删除被禁用或不相关的标签。
  5. 字幕用的事实信息:首领/角色/物品的名称及难度,确保字幕准确。绝不编造事实;如果不确定,保持字幕通用性。
  6. 地区特性:当地语言/俚语、当地创作者的内容格式、当周的当地活动。

然后主动提供改进建议(当研究支持时),例如:“这个首领在 <日期> 补丁后成为趋势——以此作为开篇”,“目前 30 秒短视频效果优于 60 秒”,“续作公告使此内容具有时效性——今天发布”。注明每个主张的来源。将其压缩至 3-5 个最有用的要点。

3. 规划和字幕

  1. 检查分析摘要是否合理。对于游戏:死亡、胜利、最终尝试。如果胜利片段缺失或错误,请用户提供时间戳并使用 key_moments 再次调用 create_project。对于脱口秀、体育和教程,“死亡”不适用:高光模板会选择动作和声音最集中的时刻,而带有标签的 key_moments 则锁定用户关心的部分(该标签将作为该时刻的字幕)。
  2. plan_edit(自动模板:逆转 / 胜利 / 高光集锦)。字幕来自需求沟通中指定语言的内置库。如果该语言没有字幕包,则字幕将以英文输出,结果会提示这一点:你可以自行翻译,或者告知用户可以通过 nookcut copy init <language> 添加一个包。
  3. suggest_copy 提供替代选项;应用最佳选项通过 update_edit(如果在线,则结合你的研究):
    • 钩子 (segment 0):好奇心 + 利害关系,不超过 6 个词,例如 "I DIED 7 TIMES|TO GET THIS"
    • 垂直字幕:每行最多 16 个字符,| 换行,顶部最多 2 行
    • 使用需求沟通中指定的语言;保持游戏/首领名称准确
    • 结尾卡片:提出一个问题,引导评论
    • music_style:taiko(武士、武术、历史类)、pulse(射击、科幻、电竞、科技类)、cinematic(首领、奇幻、史诗、体育类)
  4. preview_plan 返回联系表图片。查看图片,修复明显错误的选择(黑帧、菜单、加载画面),使用 update_edit。然后向用户展示预览和片段列表,在渲染前获得用户批准。

4. 制作

generate_music(如果音乐选项为 none 则跳过)-> render_video 并使用 suggest_copy 提供的 file_name(或研究中得到的关键词丰富的文件名)-> export_resolve(传入渲染路径),以便用户在 DaVinci Resolve 中微调。

耗时步骤(分析、渲染):请保持用户知情。 使用 wait=false 启动它们,然后每隔几秒轮询 job_status,并用通俗语言报告 progress(例如“渲染 14/24 片段,62%,大约还剩 40 秒”)。告知用户一次:他们也可以在终端中使用 nookcut watch <project> 实时观看。如果用户想停止,调用 cancel_job:它会立即结束所有 ffmpeg 进程,从而释放计算机资源。 NookCut 可能作为所有会话的共享服务器运行(nookcut service);这样,即使当前对话结束,任务也会继续运行。在你结束前,请确保所有你启动的任务都已停止(除非用户希望其继续运行),并告知他们之后如何停止(在任何会话中运行 cancel_job,或在终端中运行 nookcut cancel <project>)。如果工具不可达,请用户运行 nookcut service status(以及如果服务未运行,则运行 nookcut service restart)。

当工具失败时,错误信息以括号内的代码开头,后跟普通消息和“如何处理”行。用自己的话向用户转述这些信息,并遵循提示;不要原样重试相同的调用。[busy] 表示该项目上已有任务在运行:报告其进度,而不是启动另一个。[environment] 表示需要安装某些东西:显示命令并等待。除非用户要求,否则保持“详细信息(用于错误报告)”不出现在对话中。

5. 发布工具包和时间安排

  1. best_posting_times(region):以用户本地时间展示接下来的最佳发布窗口,明确说明这些是估算值,并传递结果中的分析指标提示。
  2. 离线:write_publish_kit(project_dir, video_path) 使用内置库填写标题、描述和标签(或传入你从 suggest_copy 中选择的那些)。
  3. 在线:传入你研究得到的标题、描述和标签,以及总结来源和趋势发现的 research_notes。
  4. 绝不代表用户上传或发布。将文件和相关计划移交给用户。

规则

  • 源文件永远不会被修改;所有操作结果都写入项目文件夹内。
  • 音乐是从头合成的(无样本或现有录音),因此无法匹配源音轨。不要承诺绝对不会被版权声明误判:自动检测系统偶尔会误报,用户可以提出争议。如果用户提供自己的音轨,提醒他们需要拥有其版权。平台的热门音效必须在平台自己的应用内添加。
  • 绝不编造字幕或标题中的事实(如首领名称、分数、“一次过”、“无伤”)。使用分析、需求沟通或你的研究所支持的内容。
  • 如果某步骤失败,报告确切的错误以及你接下来将尝试的操作;没有渲染文件的情况下绝不宣称成功。
  • 如果原始音频是静音的,请说明情况并建议检查其录制设置。

相关技能