Communitygithub.com

纪实纪录片风格

为Claude提供纪实纪录片风格视频编辑:带上下黑边的画面、电影级调色、小写字母字幕及地点标签。适用于微型纪录片、创始人故事、旅行、采访、品牌宣传片。可将原始素材处理成9:16的最终成片,基于video-studio-core引擎(自动转写、自动剪辑、动态图形、音效、调色)。

纪实纪录片风格 是什么?

Doc Real 是一个专为 Claude 视频编辑工作流设计的纪实纪录片风格模板。它利用 video-studio-core 引擎,将原始拍摄素材自动处理成具有电影质感的 9:16 竖屏短片。该风格默认包含上下黑边、电影级调色、颗粒感、慢速推进镜头、小写白色居中字幕以及前 3 秒左上角的地点或章节标签。它特别适合制作微型纪录片、创始人故事、旅行游记、访谈和品牌宣传片。用户可以通过编辑 plan.json 文件微调剪辑方案,包括改写开场钩子、修正 AI 听错的文字、调整字幕样式等。最终成片输出为 final.mp4,并支持生成 1:1 和 16:9 等多种尺寸,以及额外添加背景音乐。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

在你喜欢的 AI 中提问

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

文档

纪实纪录片风格 是做什么的?

纪实纪录片风格:上下黑边画面、电影级调色、小写字母字幕及地点标签。

  • 最佳用途: 微型纪录片、创始人故事、旅行游记、采访、品牌宣传片
  • 类别: 人物出镜视频
  • 默认格式: 9:16(可通过 --format 9:16 | 1:1 | 4:5 | 16:9 更改)
  • 需要镜头素材: 是,原始出镜讲话片段
  • 说话人背后文字: 否

开始之前

此风格基于 video-studio-core 技能运行,该技能必须安装在同一技能文件夹中。

  • CORE = 本文件夹旁边的 video-studio-core 文件夹(例如 ~/.claude/skills/video-studio-core)。
  • STYLE = 本技能的文件夹(包含 theme.json 和 theme.css)。
  • 首次在某个机器上使用时:python CORE/scripts/check_env.py,并修复它报告的任何问题。
  • 如果 CORE 缺失,请告知用户从同一资源包安装 video-studio-core。

执行剪辑

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "地点, 时间"
# 优化 edit-*/plan.json(见下文),然后检查静态帧:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

在完整渲染前,打开 contact_sheet.png 仔细查看。最终视频位于工作文件夹中的 final.mp4 文件。 使用 finish.py 的 --formats 1:1,16:9 参数生成其他尺寸。在 plan.json 中添加音乐:"music": {"src": "track.mp3", "volume": 0.12}。

视觉效果

  • 上下黑边、电影级调色、颗粒感、慢速推进镜头。字幕:小写、白色、居中、低位置。
  • 前 3 秒左上角显示一个小型地点或章节标签。无缩放动效、无表情符号、无音效。

优化剪辑方案

make_plan.py 生成的草稿是自动化的。你需要让它变得更好:

  • 阅读 words.json,将开场钩子(前 2-3 秒)改写为简短、具体的承诺。
  • 替换 AI 自动选取的弱关键词,使用能够传达核心意思的词(数字、结果、名称、对比)。
  • 修正 words 数组中听错的词语(保持其时间戳不变)。
  • 通过 --title 参数传入地点/背景信息(例如 'julana, haryana — 6:40 am')。
  • 对于较长的影片,添加带有 dr-chapter 类的 titlecard 章节分隔。
  • 元素类型和字段说明请参考:CORE/references/plan-schema.md。

交付前检查

  • 联系表:文字可读、无内容被裁剪、无物体遮挡面部(除非有意为之)、安全区域合规(9:16:文字保持在高度的 10% 至 85% 之间)。
  • 检查时间线:叠加应与话语同时出现,而非之后。
  • 使用 ffprobe 检查最终文件:确保尺寸、时长和音频正确。
  • 告知用户你删减了多少内容(去除的秒数)、该视觉效果带来了什么提升,以及最终文件存放的位置。

更改视觉效果

颜色和字体位于 theme.json(vars、fontsUrl)和 theme.css 中。对于一次性更改,可以直接编辑 plan.json(theme.vars、元素 style),而无需修改技能文件。

示例请求

  • "纪录片风格剪辑。"
  • "让我的故事看起来像 Netflix 纪录片。"
  • "带有地点标签的电影级纪录片风格。"

Individual skills in this repo

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

相关技能