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

scripts/explainer_beats.js

View on GitHub
#!/usr/bin/env node
'use strict';

/* explainer beats:从 narration-timing.json 的 phrase 边界 + 场景内静音检测推导动作节拍,
   写回 production-spec.json 的 scenes[].beats。
   原则:动作节拍落在旁白语流的分句点上,而不是按场景时长比例猜(声画对齐)。
   beats.at 为场景相对秒数,供 component-runtime.js 的 parseBeats 消费。 */

const fs = require('fs');
const path = require('path');
const { spawnSync } = require('child_process');

function preferredFfmpeg() {
  return [process.env.QIAOMU_FFMPEG, '/opt/homebrew/opt/ffmpeg-full/bin/ffmpeg', '/usr/local/opt/ffmpeg-full/bin/ffmpeg', 'ffmpeg']
    .find((binary) => binary && spawnSync(binary, ['-v', 'error', '-version'], { stdio: 'ignore' }).status === 0) || null;
}

function readJson(file, label) {
  try {
    return JSON.parse(fs.readFileSync(file, 'utf8'));
  } catch (error) {
    throw new Error(`Cannot read ${label || file}: ${error.message}`);
  }
}

/** 场景音频窗口内的静音段中点(场景相对秒,升序)。 */
function silenceMidpoints(ffmpeg, audio, startMs, endMs) {
  const duration = Math.max(0.2, (endMs - startMs) / 1000);
  const result = spawnSync(ffmpeg, [
    '-hide_banner', '-nostats',
    '-ss', (startMs / 1000).toFixed(3), '-t', duration.toFixed(3), '-i', audio,
    '-af', 'silencedetect=noise=-35dB:d=0.22', '-f', 'null', '-'
  ], { encoding: 'utf8' });
  const output = `${result.stdout || ''}\n${result.stderr || ''}`;
  const starts = [...output.matchAll(/silence_start:\s*([\d.]+)/g)].map((m) => Number(m[1]));
  const ends = [...output.matchAll(/silence_end:\s*([\d.]+)/g)].map((m) => Number(m[1]));
  const midpoints = [];
  for (let i = 0; i < Math.min(starts.length, ends.length); i += 1) {
    const mid = (starts[i] + ends[i]) / 2;
    if (mid > 0.3 && mid < duration - 0.3) midpoints.push(Number(mid.toFixed(3)));
  }
  return { midpoints, duration };
}

/** process 场景:为 stepCount 个步骤挑激活时刻。优先用静音中点,不足时均匀兜底。 */
function processBeats(midpoints, duration, stepCount) {
  const beats = [];
  const usable = midpoints.filter((t) => t > 0.5);
  for (let i = 0; i < stepCount; i += 1) {
    let at;
    if (i === 0) {
      at = Math.min(1.2, Math.max(0.5, duration * 0.08));
    } else if (usable.length >= i) {
      at = usable[i - 1] + 0.15; // 分句点后稍落拍
    } else {
      at = duration * (0.15 + (0.72 * i) / stepCount); // 与运行时默认均铺一致
    }
    beats.push({ at: Number(Math.min(duration - 0.6, at).toFixed(3)), action: 'activate', target: i });
  }
  return beats;
}

/** state 场景:swap 落在 40% 之后最近的分句点;收尾前加一个 pulse 重音。 */
function stateBeats(midpoints, duration) {
  const beats = [];
  const swapCandidates = midpoints.filter((t) => t > duration * 0.3 && t < duration * 0.8);
  if (swapCandidates.length) {
    const target = duration * 0.55;
    const swapAt = swapCandidates.reduce((best, t) => (Math.abs(t - target) < Math.abs(best - target) ? t : best), swapCandidates[0]);
    beats.push({ at: Number(swapAt.toFixed(3)), action: 'swap' });
  }
  const pulseCandidates = midpoints.filter((t) => t > duration * 0.7 && t < duration - 0.5);
  if (pulseCandidates.length) {
    beats.push({ at: Number(pulseCandidates[pulseCandidates.length - 1].toFixed(3)), action: 'pulse' });
  }
  return beats;
}

function stepCountOf(scene) {
  if (['reward-loop', 'pipeline'].includes(scene.component)) return Math.min(6, (scene.items || []).length || 3);
  if (scene.component === 'definition' && Array.isArray(scene.items) && scene.items.length > 1) return Math.min(8, scene.items.length);
  return 0;
}

function deriveBeats(projectRoot, options = {}) {
  const specFile = path.join(projectRoot, 'production-spec.json');
  const spec = readJson(specFile, 'production-spec.json');
  if (!spec.timing || !spec.timing.contract) {
    return { ok: false, applied: false, error: 'timing not locked; run qcut explainer timing --apply first.', scenes: [] };
  }
  const timing = readJson(path.join(projectRoot, spec.timing.contract), spec.timing.contract);
  const audio = timing.audio && timing.audio.path;
  if (!audio || !fs.existsSync(path.join(projectRoot, audio))) {
    return { ok: false, applied: false, error: 'narration audio from timing contract is missing.', scenes: [] };
  }
  const ffmpeg = preferredFfmpeg();
  if (!ffmpeg) return { ok: false, applied: false, error: 'ffmpeg unavailable.', scenes: [] };
  const phraseByScene = new Map((timing.phrases || []).map((p) => [p.sceneId || p.id, p]));

  const summaries = [];
  for (const scene of spec.scenes || []) {
    const kind = String(scene.visibleChange && scene.visibleChange.kind || 'none');
    if (kind === 'none') { summaries.push({ id: scene.id, kind, beats: 0, source: 'skipped' }); continue; }
    const phrase = phraseByScene.get(scene.id);
    const duration = Number(scene.duration) || ((phrase ? (phrase.endMs - phrase.startMs) : 0) / 1000);
    let beats = [];
    let source = 'fallback-spread';
    if (phrase) {
      const { midpoints } = silenceMidpoints(ffmpeg, path.join(projectRoot, audio), phrase.startMs, phrase.endMs);
      const steps = stepCountOf(scene);
      if (kind === 'process' && steps > 1) beats = processBeats(midpoints, duration, steps);
      else if (kind === 'state') beats = stateBeats(midpoints, duration);
      if (beats.length && midpoints.length) source = 'silence-aligned';
    }
    if (beats.length) scene.beats = beats;
    else delete scene.beats;
    summaries.push({ id: scene.id, kind, beats: beats.length, source });
  }

  if (options.apply) {
    fs.writeFileSync(specFile, `${JSON.stringify(spec, null, 2)}\n`);
  }
  return {
    ok: true,
    applied: Boolean(options.apply),
    timingLevel: timing.timingLevel || null,
    scenes: summaries,
    next: options.apply
      ? 'Re-run qcut explainer materialize, then preview. Hand-authored scenes ignore spec beats; adjust their hardcoded timings manually.'
      : 'Dry run. Re-run with --apply to write beats into production-spec.json.'
  };
}

module.exports = { deriveBeats, silenceMidpoints, processBeats, stateBeats };

if (require.main === module) {
  const args = process.argv.slice(2);
  const project = args.find((a) => !a.startsWith('--'));
  if (!project) {
    process.stderr.write('Usage: explainer_beats.js <project-dir> [--apply] [--json]\n');
    process.exitCode = 2;
  } else {
    try {
      const result = deriveBeats(path.resolve(project), { apply: args.includes('--apply') });
      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
      if (!result.ok) process.exitCode = 1;
    } catch (error) {
      process.stderr.write(`${error.message}\n`);
      process.exitCode = 1;
    }
  }
}
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: 322kUpdated 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