Skip to content

joeseesun/qiaomu-cut-skill

qiaomu-cut

Verified

把一句话需求转成可复现、可验收视频工程的乔木智能剪辑导演。Use when the user asks to create, plan, edit, remix, explain, narrate, subtitle, animate, composite, or render a video—including one-line requests such as “制作一个科普视频:介绍 LLM 中的 RL”. Builds English-learning movie mixes, person profiles, explainers, code-drawn motion graphics (UI morph loops, showreels, kinetic-type promos, line-art/pixel/Three.js animation, lyric MVs), product launch videos, cinematic shorts, social clips, course/PPT videos, AI image/video/TTS/music-assisted stories, stock-footage stories, or multi-source montage. Routes across 33台词, ClipSeek/open media, local files, ListenHub, image generation, HTML/SVG/Canvas motion graphics with beat-grid storyboards and determinism probes, Manim, ffmpeg-full, captions, sound design, frame-0 video covers with YouTube thumbnails, and release checks.

FileKindSize
SKILL.mdskill md54.0 KB
agents/interface.yamlconfig17.2 KB
agents/openai.yamlconfig323 B
assets/explainer-social/base.cssother24.9 KB
assets/explainer-social/component-runtime.jsscript41.1 KB
assets/explainer-social/scene-shell.htmlother829 B
assets/motion-kit/qiaocut-motion.jsscript8.2 KB
assets/qiaomu-profile/qiaomu_avatar.jpegbinary5.6 MB
assets/qiaomu-profile/qiaomu_reward_qr.pngbinary515.9 KB
assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpgbinary8.3 KB
references/ad-concept-library.mdmarkdown6.5 KB
references/aesthetic-preferences.mdmarkdown3.0 KB
references/brand-card-templates.mdmarkdown1.6 KB
references/chinese-font-themes.mdmarkdown804 B
references/cinematic-techniques.mdmarkdown2.8 KB
references/code-motion-direction.mdmarkdown11.1 KB
references/cover-thumbnail-method.mdmarkdown6.4 KB
references/english-mix-fast-path.mdmarkdown6.0 KB
references/explainer-autopilot.mdmarkdown11.1 KB
references/feedback-evolution.mdmarkdown37.6 KB
references/ffmpeg-full.mdmarkdown1.7 KB
references/incremental-production.mdmarkdown4.4 KB
references/licensing.mdmarkdown1.9 KB
references/listenhub-provider.mdmarkdown12.6 KB
references/motion-prompt-patterns.mdmarkdown9.3 KB
references/movie-montage-fast-path.mdmarkdown4.4 KB
references/qiaocut-ir.mdmarkdown4.2 KB
references/renderer-engines.mdmarkdown3.3 KB
references/schemas/qiaocut.timeline.v1.schema.jsonconfig7.2 KB
references/social-safe-zones.mdmarkdown3.3 KB
references/source-adapters.mdmarkdown5.7 KB
references/source-selection-gate.mdmarkdown2.5 KB
references/styles/cinematic.mdmarkdown475 B
references/styles/explainer.mdmarkdown1.5 KB
references/styles/social-short.mdmarkdown383 B
references/timeline-schema.mdmarkdown12.2 KB
references/trust-boundary.mdmarkdown3.0 KB
references/workflows.mdmarkdown7.5 KB
scripts/adapters/33tc.jsscript2.1 KB
scripts/adapters/33tc_cli.jsscript4.8 KB
scripts/adapters/clipseek.jsexecutablescript5.4 KB
scripts/adapters/listenhub.jsscript35.7 KB
scripts/adapters/listenhub_cli.jsexecutablescript2.1 KB
scripts/adapters/local.jsscript2.4 KB
scripts/audio_beats.jsscript17.5 KB
scripts/bilingual_typography_smoke.jsscript1.4 KB
scripts/bootstrap_listenhub.shexecutablescript5.4 KB
scripts/bootstrap_macos.shexecutablescript2.5 KB
scripts/brand_templates.jsscript2.4 KB
scripts/brand_templates_smoke.jsscript869 B
scripts/complete_sentence.jsscript3.9 KB
scripts/component_motion_smoke.jsscript21.2 KB
scripts/concept_smoke.jsscript5.6 KB
scripts/cover.jsscript9.1 KB
scripts/cover_smoke.jsscript5.1 KB
scripts/english_mix.jsscript24.1 KB
scripts/english_mix_smoke.jsscript5.7 KB
scripts/explainer_beats.jsscript6.7 KB
scripts/explainer_beats_smoke.jsscript4.8 KB
scripts/explainer_cognitive_timing_smoke.jsscript5.8 KB
scripts/explainer_e2e_smoke.jsscript7.4 KB
scripts/explainer_pipeline.jsscript49.3 KB
scripts/explainer_pipeline_smoke.jsscript12.7 KB
scripts/explainer_spec.jsscript51.4 KB
scripts/explainer_timing.jsscript8.6 KB
scripts/fetch_generated.jsexecutablescript17.4 KB
scripts/ffmpeg_retry_shim_smoke.jsscript2.3 KB
scripts/file_narration_smoke.jsexecutablescript6.6 KB
scripts/ingest_asset.jsexecutablescript15.0 KB
scripts/kinetic_caption_smoke.jsscript1.4 KB
scripts/license_report.jsexecutablescript2.3 KB
scripts/listenhub_narration.jsexecutablescript11.0 KB
scripts/listenhub_smoke.jsexecutablescript26.7 KB
scripts/local_preferences.jsscript1.8 KB
scripts/motion_studio.jsscript55.9 KB
scripts/motion_studio_smoke.jsscript11.0 KB
scripts/movie_montage.jsscript24.7 KB
scripts/movie_montage_smoke.jsscript4.0 KB
scripts/qcut.jsexecutablescript40.8 KB
scripts/release_check.jsscript7.0 KB
scripts/render_project.jsscript85.1 KB
scripts/render_scene.jsscript26.4 KB
scripts/renderers/ass.jsexecutablescript2.7 KB
scripts/renderers/bilingual_ass.jsscript12.6 KB
scripts/renderers/html_scene.jsexecutablescript3.9 KB
scripts/renderers/procedural_music.jsscript7.6 KB
scripts/scene_content_cache.jsscript3.2 KB
scripts/scene_renderer_smoke.jsscript2.8 KB
scripts/security_smoke.jsscript10.2 KB
scripts/sentence_boundary_smoke.jsscript1.6 KB
scripts/setup_deps.jsscript8.4 KB
scripts/shims/ffmpegexecutablescript3.0 KB
scripts/source_review.jsexecutablescript5.1 KB
scripts/timeline_features_smoke.jsscript3.7 KB
scripts/trigger_eval.pyexecutablescript2.5 KB
scripts/validate_skill.pyexecutablescript3.1 KB
scripts/verify_marswave_vendor.jsexecutablescript3.5 KB
scripts/verify_video.jsexecutablescript3.4 KB

references/english-mix-fast-path.md

View on GitHub
# English Mix Fast Path

目标:把影视英语学习混剪的昂贵错误拦在远端裁切之前,把网络恢复、源素材验收和字幕手机审查变成可复现命令。

## 1. 初始化

```bash
node scripts/qcut.js english-mix init ./project \
  --phrases "That makes sense.|I see what you mean." \
  --clips-per-phrase 4 --json
```

命令创建 `source-selection.json` 和 `assets/source`、`assets/rejected`、`captions`、`scenes`、`renders`、`reports`。`targetCount` 是上限,不得重复素材凑数。

## 2. 付费前锁定字幕上下文

搜索池至少为目标数的 2–3 倍。每个候选在 `clips[]` 保存:

```json
{
  "id": "makes-01",
  "videoId": 7350,
  "sourceStartMs": 1389480,
  "sourceEndMs": 1395150,
  "english": "Does that make sense? That makes sense.",
  "contextBefore": 1,
  "subtitleWindow": {
    "before": [
      { "start": 1387.63, "end": 1389.63, "content": "We need one more person" }
    ],
    "previous": { "start": 1389.93, "end": 1392.64, "content": "so then we'll focus on plating the dishes." },
    "current": { "start": 1392.72, "end": 1394.40, "content": "Does that make sense? That makes sense." },
    "next": { "start": 1394.47, "end": 1396.89, "content": "Okay. Thank you, everyone." }
  }
}
```

时间单位为秒;付费 range 仍用毫秒。运行:

```bash
node scripts/qcut.js english-mix audit ./project --strict-boundaries --json
```

如果 setup 以小写、标点或省略号开始,说明它可能位于句中;继续向前取字幕,直到语义起点明确。不能把 `previous/current/next` 只有三条当成完整上下文保证。

## 3. 远端裁切与恢复

核对片名、范围、输出目录和预计任务数,得到当前明确确认后才传 `--yes`。并发控制在 2 个下载任务,避免同时对媒体 CDN 建立过多长连接。

`qcut 33tc pick|cut|download` 会为 HTTP(S) 媒体输入注入有限的 ffmpeg reconnect/retry。若仍失败但输出包含 task ID:

```bash
node scripts/qcut.js 33tc download EXISTING_TASK_ID \
  --no-status --output ./project/assets/source
```

不得重新运行 `cut --yes` 只为修下载;这会重复创建可能收费的任务。`QIAOMU_33TC_FFMPEG_RETRY=off` 仅用于诊断。

## 4. 下载后硬审计

稳定重命名为 `assets/source/<clip-id>.mp4`,随后运行:

```bash
node scripts/qcut.js english-mix audit ./project \
  --require-media --strict-boundaries --json
```

审计写入 `reports/source-audit.json`,硬拦截:

- 纯音频或缺少音轨;
- 重复 video/range 或重复文件 SHA-256;
- 目标表达未出现在 selection/SRT;
- 付费范围晚于完整上下文起点或早于完整句落点;
- 严格模式下没有 `subtitleWindow` 证据。

不合格文件移到 `assets/rejected/` 并保留 task ID 与原因,不进入 timeline。

## 5. 给影视片段留呼吸

完整句并不自动等于舒服的剪辑点。通过素材审计后、写 timeline 前运行:

```bash
node scripts/qcut.js english-mix pace ./project --crossfade-ms 200 --apply --json
```

默认生成 `assets/processed/<clip-id>.mp4`,不覆盖 `assets/source/` 原始下载:

- 裁句:在 selection 的 clip 上写 `trimStartMs/trimEndMs`,先去掉落在边界上的半句或下一句残片;
- 开头:静音首帧 60 ms,音频淡入 40 ms,只用于防爆音,不制造明显等待;
- 结尾:音频淡出 160 ms,静音尾帧 500 ms;配合 200 ms 转场时,至少约 300 ms 完整尾帧后才开始换画面;
- 验收:首尾采样必须低于 -60 dB,结果写入 `reports/english-mix-pacing.json`;
- timeline 使用 selection 中的 `processedPath`,字幕时间整体后移 `leadHoldMs`;
- 每个非首 shot 写入 `transition: {"type":"fade","duration":0.2}`。渲染器同步执行 audio acrossfade,caption/shot 起点要扣除相同 overlap。

优先通过扩大原始 range 获得真实环境声停顿;但如果扩大范围会切入下一句,就裁掉残句,再使用上述静帧 + 静音派生。参数可按语速调整,但开头不得低于 20 ms,结尾不得低于 200 ms。静音派生后仍使用硬切会出现“停住—跳画面—再停住”,这是失败状态;必须在 preview 的 render report 中看到非空 transitions。

品牌卡的第 0 帧必须已经是完整可读封面,不允许先空白再慢慢组装。封面与短语介绍卡必须分开计时:封面最长 700 ms;短语介绍卡默认 2000 ms、最长 2200 ms,确保表达与释义可以从容读完;第一句有效原声最晚在 2.6 秒出现。用 `silencedetect` 实测,不凭时间线目测判断。

## 6. 一次渲染全部品牌卡

把片头、分组卡、复习卡和片尾写入项目内 batch JSON:

```json
{
  "scenes": [
    { "source": "scenes/intro.html", "engine": "html", "output": "assets/cards/intro.mp4", "duration": 2.8, "width": 1080, "height": 1920, "fps": 30 },
    { "source": "scenes/outro.html", "engine": "html", "output": "assets/cards/outro.mp4", "duration": 3.2, "width": 1080, "height": 1920, "fps": 30 }
  ]
}
```

```bash
node scripts/qcut.js scene batch ./project scenes/cards-batch.json --json
```

1–32 个 HTML/SVG 场景共用一次 Chrome 启动。不要在 shell 循环里逐个执行 `scene render`。

## 7. Preview 与手机审查

```bash
node scripts/qcut.js render ./project --profile preview --json
node scripts/qcut.js english-mix review ./project --frames 8 --json
```

后一个命令从 `sourceAudio=true` 镜头自动取最多 8 个代表帧,并定位最长 English caption 生成手机尺寸单帧:

- `reports/english-mix-review/contact-sheet.jpg`
- `reports/english-mix-review/phone-long-caption.png`
- `reports/english-mix-review/review.json`

必须人工确认三层字幕不压电影画面、人物或原片字幕,同时评估 TikTok/抖音 UI 风险。修订 captions 时复用 shot cache;不用重做远端素材和卡片。

## 8. Final

只有 source audit、代表帧、手机帧和内容审看都通过后运行 final。报告实际任务数、被拒素材、积分前后差、来源/许可、响度、黑场和计划内静音。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall