Communitygithub.com

短视频制作

制作一段已审批的短视频,或修正现有视频的背景音、情感、字幕、混音或导出。仅生成更改的旁白,渲染并预览当前版本,执行技术和编辑质量检查,然后导出。排除仅限脚本和一般音频建议的请求。

短视频制作 是什么?

该技能(Hownameee/short-videos)专为AI代理设计,用于管理短视频制作工作流,支持从已审批的脚本创建新视频或修正现有视频。它遵循严格的审批和版本控制:用户必须提供匹配的脚本审批和明确的制作请求,而修正仅授权范围性的修订和替换交付物。技能集成了八个步骤的流水线,包括语音生成、资产解析、预渲染检查、预览渲染、编辑质量检查(含口语清晰度、音乐弧线和手机/单声道播放测试)、最终导出以及原子化交付。支持特定的修正类型:对于音乐、增益、淡入淡出、音效或字幕模式的覆盖修改,使用`revise`命令;对于更改旁白或视觉内容,需重新起草、重新审批并运行`revise`。该技能与Kokoro TTS(旁白生成)、短视频视觉设计(视觉更改)和Remotion最佳实践(代码更改)等工具协同工作,并引用声音质量控制和视频制作默认文档。平台支持包括基于CLI的命令(npm run video)和结构化配置文件(production.json、state.json),强调水印验证、资产完整性、测量记录(使用`<measured>`占位符)以及不要在输出中包含黑色/缺失帧、机密或内部提示。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-production

在你喜欢的 AI 中提问

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

文档

短视频制作 是做什么的?

检查目标 state.json、已审批的 video.json、script.md 和现有的制作笔记。 阅读 默认设置 一次。 使用已安装的运行时和 现有命令。

要求匹配脚本审批和明确的制作请求。修正现有视频的请求授权范围性的修订和替换交付物。不要重新开始发现或请求已经给予的审批。空运行检查并规划,但不创建媒体或声称测量结果。

修订

对于音乐、增益、淡入淡出、音效或字幕模式,运行 npm run video -- revise --project projects/NNN-topic,然后编辑 production.json。保留已审批的旁白和视觉效果。此覆盖保留 遗留的审批哈希。在 PRODUCTION.md 或覆盖中记录声音意图。

对于更改的旁白、场景内容、语音设置或设计数据,编辑 脚本/配置,运行 script --draft,获得审批(除非已明确给出),然后 script --approve。草稿现在在制作后工作并保留 上一个交付物。如果存在覆盖,则在重新审批后运行 revise。 永远不要手动重写审批哈希。编写 覆盖或更改结构化字段时,请参考 合同。两个主题渲染器未实现 故事板覆盖,因此会被拒绝而不是静默忽略。

聚焦阅读

需要的工作阅读
声音选择、情绪或混音声音质量控制;相关的背景指南部分
生成/更改旁白Kokoro
更改艺术方向、布局、场景运动或字幕用户界面视觉设计
更改 Remotion 代码Remotion 实践,然后仅相关 API/规则参考

不要为仅进行增益修正而加载语音设置、视觉设计、蓝图或所有 Remotion 包。当需要其 API 指导时,使用导入的聚焦包,并对照官方文档验证不确定的版本细节。在工作报告中列出实际使用的指导。

制作和检查

  1. 保留已审批的承诺、声明证据、回报和上下文行动号召。 为新场景记录视觉主题和行动/提示/稳定。新主题需要 自己的渲染器;永远不要将 Kubernetes 图伪装成通用输出。
  2. 当需要更新旁白时,使用共享语音生成器。它验证并 重用未更改的 WAV 和时间;更改会重新生成受影响的场景。测量 持续时间,保留提供者预测的词时间戳,并审查发音。
  3. 解析资产并记录来源/许可。实现有目的的声音弧线: 钩子 → 解释 → 揭示 → 结尾;先混语音,其次可听到的音乐, 最后选择性音效。应用声音质量控制,包括在可用时进行渲染监听。
  4. 在渲染之前运行 video preflight --project …。它验证支持的 配置、资产路径/校验和、语音顺序/时间、音乐信号和持续时间。 解决失败;不要绕过它们或伪造测量结果。
  5. 渲染 --preview。检查接触表(开头、每个场景、结尾) 的焦点、可读的手机文本、安全区域、资产质量和连贯的 视觉风格。检查每个主要运动节拍的回放/连续帧。 单帧无法建立有意义的动画。
  6. 检查至少三个连续的词高亮和稍后的场景/块; 记录帧时间和时间源。检查缺失/重复/发音错误的 词、语音可懂度、音乐弧线、淡入淡出、循环和手机/单声道回放。 将编辑证据保存在 output/qc.json 中,与资产/输出校验和关联。 修复已证明的缺陷并重新生成受影响的工作和预览。
  7. 从当前预览渲染 --final。CLI 检查指纹、 时间线持续时间、尺寸/FPS、H.264/AAC、完整解码、响度和真实 峰值。它将 output/automated-qc.json 与编辑质量控制分开写入。
  8. 交付实际的最终版本、报告和快照。CLI 原子性地替换 最终版本/报告/快照/状态,并在检查后仅归档精确共享的 renderer/src/; 失败则保留上一个最终版本。如果制作命名副本,请验证请求的 命名副本与最终校验和匹配。

输出中没有黑色/缺失帧、模糊的回报、秘密或内部提示。 保留资产权利记录;购买或发布是单独的授权。 仅凭背景资产存在或最终响度无法证明可听到的情感契合。 如果无法监听,请完成授权的测量导出,将其标记为 not-performed, 并披露限制。不要发明通过。

空运行响应:一个预检表、有序计划、质量控制列表和工件列表。 对尚未进行的测量使用 <measured> 占位符。

Individual skills in this repo

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

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

相关技能