Qiaomu Cut

选一个任务，开始使用

先在新的工作目录执行安装命令，再重新加载该目录的 Claude Code。以下命令均从这个工作目录运行；qcut 工程是其中的子目录。方括号换成真实输入，已有同名工程时改用新名称并同步后续命令。

1. 安装完整 Skill 与配套脚本

   复制安装命令

   在新的工作目录执行，固定安装器与本次所读提交，只选 qiaomu-cut 并复制到 Claude Code 的项目目录。先核对安装摘要，再重新加载项目；这一步不会同时装好全部媒体依赖。

   npx [email protected] add https://github.com/joeseesun/qiaomu-cut-skill/tree/549813500aab9fb89032f2fbe34178a85c43b4f2 --skill qiaomu-cut -a claude-code --copy
   node .claude/skills/qiaomu-cut/scripts/qcut.js setup --only ffmpeg,font --check --json

   阅读作者入口与安装说明

   先检查，再补当前任务缺的组件

   确认 .claude/skills/qiaomu-cut/ 下有 SKILL.md、scripts、references 和 assets。运行 node .claude/skills/qiaomu-cut/scripts/qcut.js doctor --json，并查看具体组件结果，不能只看顶层 ok。首项本地剪辑再用 setup --only ffmpeg,font --check --json 检查所需组件；确需安装时去掉 --check。不要因未使用的 Manim 或 ListenHub 缺失而自动安装全部组件。

   查看依赖安装实现

2. 把这段话发给 AI

   复制提示词

   以下是编辑设计的可执行任务示例，并非本站生成的视频案例。提示词中的产物和检查项是使用时的目标；本次只核对了文档与源码。

   请使用 qiaomu-cut，先读已安装的 SKILL.md 与 references/timeline-schema.md。本次只用两段本地视频 [片段 A 路径]、[片段 B 路径] 和我提供的字幕 [文字及时间码]，保留原声、使用我的品牌，不加作者关注片尾，不调用生成服务或 ASR。 从工作目录运行： node .claude/skills/qiaomu-cut/scripts/qcut.js scaffold ./local-first-cut --brief "两段自有素材的 8 秒竖屏演示" --workflow social-short --duration 8 --format 9:16 --json 将 qiaocut-ir.json 的模板分镜改为这两段实际镜头。把素材复制到这个新工程的 assets/a.mp4、assets/b.mp4，保留原文件，记录真实来源与使用范围到 assets-manifest.json 和 license-report.md。检查各有可用的视频、音频，以及从 0 秒开始至少 4 秒的内容；若这些范围会截断一句话，请先给出调整方案，不假装 8 秒要求已经满足。 自行创建 scaffold 没有生成的 timeline.json：schema 为 qiaocut.timeline.v1；output 为 1080×1920、30 fps、duration=8、loudnessLufs=-14、truePeakDb=-1.5、file=renders/final.mp4。两段 shots 分别为 video，path=assets/a.mp4 和 assets/b.mp4，in=0、duration=4、fit=containBlur、sourceAudio=true；用硬切，不加重叠转场。设置 narration={"engine":"none"}、music=false、captionSource=captions/captions.json、captions=captions/final.ass。 创建 captions 目录；把已核对的原声字幕写为 events，使用 English/Chinese 中实际需要的样式、start/end 秒数和 text，字体用 Noto Sans CJK SC。第二段字幕要平移到整片第 4 秒以后；不要从文字长度猜逐词时间。检查字幕不越过 8 秒，不遮主体或原片文字。 node .claude/skills/qiaomu-cut/scripts/qcut.js render ./local-first-cut --profile preview --json 打开实际 renders/final.preview.mp4，带声音核对裁切、主体、字幕、原声和首尾；把实际发现与修订记入 reports/editor-review.md。需要重跑时先确认仅替换生成文件，再使用 --force。审看通过后运行： node .claude/skills/qiaomu-cut/scripts/qcut.js render ./local-first-cut --profile final --json 交付工程、终稿与实际报告。确认报告 profile=final、verification.level=full、verification.ok=true、releaseReady=true；逐项处理 warnings 中的黑场/静音提示，并再次听看终稿；失败就保留错误和缺项，不以 IR、预览或终端成功字样代替完成。

3. 检查你拿到的结果

   • 预览为 local-first-cut/renders/final.preview.mp4，报告为 reports/render-report.preview.json；终稿为 renders/final.mp4，报告为 reports/render-report.json，并有默认的 reports/contact-sheet.jpg。路径都相对该工程。
   • 核对完整 8 秒、两段原声、实际字幕位置与字体。通用 render 默认就是 final，因此首次明确写 preview；preview 默认不生成联系表，也没有全片黑场扫描。
   • releaseReady 是该渲染路径的技术标记。素材权利、字幕含义、内容真实与画面是否好看仍需审看；既有文件通常需明确 --force 才会替换，不能把原素材当可覆盖输出。
   查看这项任务的作者说明