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_timing.js

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

const crypto = require('crypto');
const fs = require('fs');
const path = require('path');
const { spawnSync } = require('child_process');
const { projectPath } = require('./render_project');

const TIMING_SCHEMA = 'qiaocut.narration-timing.v1';

function commandAvailable(command, args = ['-version']) {
  if (!command) return false;
  const result = spawnSync(command, args, { stdio: 'ignore' });
  return result.status === 0;
}

function preferredTool(name) {
  const environment = name === 'ffmpeg' ? process.env.QIAOMU_FFMPEG : process.env.QIAOMU_FFPROBE;
  const candidates = [
    environment,
    `/opt/homebrew/opt/ffmpeg-full/bin/${name}`,
    `/usr/local/opt/ffmpeg-full/bin/${name}`,
    name
  ].filter(Boolean);
  return candidates.find((candidate) => commandAvailable(candidate)) || null;
}

function sha256File(file) {
  const hash = crypto.createHash('sha256');
  hash.update(fs.readFileSync(file));
  return hash.digest('hex');
}

function readJson(file, label = path.basename(file)) {
  try { return JSON.parse(fs.readFileSync(file, 'utf8')); }
  catch (error) { throw new Error(`${label} is not valid JSON: ${error.message}`); }
}

function measuredDurationMs(audio, ffprobe) {
  const result = spawnSync(ffprobe, [
    '-v', 'error', '-show_entries', 'format=duration', '-of', 'default=noprint_wrappers=1:nokey=1', audio
  ], { encoding: 'utf8' });
  const seconds = Number(result.stdout);
  if (result.status !== 0 || !(seconds > 0)) throw new Error('ffprobe could not measure a positive narration duration.');
  return Math.round(seconds * 1000);
}

function silenceMidpointsMs(audio, ffmpeg) {
  const result = spawnSync(ffmpeg, [
    '-hide_banner', '-nostats', '-i', audio,
    '-af', 'silencedetect=noise=-40dB:d=0.18', '-f', 'null', '-'
  ], { encoding: 'utf8', maxBuffer: 8 * 1024 * 1024 });
  if (result.status !== 0) return [];
  const midpoints = [];
  let start = null;
  for (const line of String(result.stderr || '').split(/\r?\n/)) {
    const startMatch = line.match(/silence_start:\s*([0-9.]+)/);
    if (startMatch) start = Number(startMatch[1]);
    const endMatch = line.match(/silence_end:\s*([0-9.]+)/);
    if (endMatch && Number.isFinite(start)) {
      const end = Number(endMatch[1]);
      if (Number.isFinite(end) && end > start) midpoints.push(Math.round((start + end) * 500));
      start = null;
    }
  }
  return [...new Set(midpoints)].sort((left, right) => left - right);
}

function budgetTargets(segments, durationMs) {
  const weights = segments.map((segment) => Number(segment.duration) > 0 ? Number(segment.duration) : 1);
  const total = weights.reduce((sum, value) => sum + value, 0);
  let cursor = 0;
  return weights.slice(0, -1).map((weight) => {
    cursor += weight;
    return Math.round(durationMs * cursor / total);
  });
}

function chooseBoundaries(targets, silences, durationMs) {
  const selected = [];
  const sources = [];
  let previous = 0;
  let silenceIndex = 0;
  for (let index = 0; index < targets.length; index += 1) {
    const remaining = targets.length - index;
    const minimum = previous + 400;
    const maximum = durationMs - remaining * 400;
    const target = Math.max(minimum, Math.min(maximum, targets[index]));
    const deviation = Math.max(1200, Math.round(durationMs * 0.035));
    let best = null;
    for (let candidateIndex = silenceIndex; candidateIndex < silences.length; candidateIndex += 1) {
      const value = silences[candidateIndex];
      if (value < minimum) continue;
      if (value > maximum) break;
      const distance = Math.abs(value - target);
      if (distance <= deviation && (!best || distance < best.distance)) best = { candidateIndex, value, distance };
    }
    if (best) {
      selected.push(best.value);
      sources.push('detected-silence');
      silenceIndex = best.candidateIndex + 1;
      previous = best.value;
    } else {
      selected.push(target);
      sources.push('budget-fallback');
      previous = target;
    }
  }
  return { boundaries: [0, ...selected, durationMs], sources };
}

function writeJson(file, value) {
  fs.mkdirSync(path.dirname(file), { recursive: true });
  const temporary = `${file}.${process.pid}.tmp`;
  fs.writeFileSync(temporary, `${JSON.stringify(value, null, 2)}\n`);
  fs.renameSync(temporary, file);
}

function roundedDurations(phrases, totalSeconds) {
  const result = phrases.map((phrase) => Number(((phrase.endMs - phrase.startMs) / 1000).toFixed(3)));
  if (result.length) {
    const beforeLast = result.slice(0, -1).reduce((sum, value) => sum + value, 0);
    result[result.length - 1] = Number((totalSeconds - beforeLast).toFixed(3));
  }
  return result;
}

function lockNarrationTiming(projectRoot, audioRelative, options = {}) {
  const audio = projectPath(projectRoot, audioRelative, 'narration audio', { exists: true });
  const specFile = path.join(projectRoot, 'production-spec.json');
  if (!fs.existsSync(specFile)) throw new Error('production-spec.json is required before locking narration timing.');
  const spec = readJson(specFile, 'production-spec.json');
  const segments = Array.isArray(spec.narrationSegments) ? spec.narrationSegments : [];
  const scenes = Array.isArray(spec.scenes) ? spec.scenes : [];
  if (!segments.length || segments.length !== scenes.length) {
    throw new Error('narrationSegments and scenes must be non-empty and have the same length.');
  }
  const ffprobe = preferredTool('ffprobe');
  const ffmpeg = preferredTool('ffmpeg');
  if (!ffprobe || !ffmpeg) throw new Error('ffmpeg-full and ffprobe are required to lock narration timing.');
  const durationMs = measuredDurationMs(audio, ffprobe);
  const silences = silenceMidpointsMs(audio, ffmpeg).filter((value) => value > 250 && value < durationMs - 250);
  const chosen = chooseBoundaries(budgetTargets(segments, durationMs), silences, durationMs);
  const phrases = segments.map((segment, index) => ({
    id: segment.id,
    sceneId: scenes[index] && scenes[index].id || segment.id,
    text: String(segment.text || '').trim(),
    startMs: chosen.boundaries[index],
    endMs: chosen.boundaries[index + 1],
    endBoundarySource: index === segments.length - 1 ? 'audio-end' : chosen.sources[index],
    confidence: index === segments.length - 1 || chosen.sources[index] === 'detected-silence' ? 0.85 : 0.35
  }));
  const fallbackBoundaries = chosen.sources.filter((source) => source === 'budget-fallback').length;
  const timingLevel = fallbackBoundaries === 0 ? 'phrase' : 'duration';
  const audioSha256 = sha256File(audio);
  const contractRelative = 'narration-timing.json';
  const contract = {
    schema: TIMING_SCHEMA,
    audio: { path: audioRelative.split(path.sep).join('/'), sha256: audioSha256, durationMs },
    timingLevel,
    alignment: {
      method: 'silencedetect-plus-authored-budget',
      detectedSilences: silences.length,
      usedSilenceBoundaries: chosen.sources.length - fallbackBoundaries,
      fallbackBoundaries
    },
    phrases
  };
  writeJson(path.join(projectRoot, contractRelative), contract);

  let applied = false;
  if (options.apply) {
    const totalSeconds = Number((durationMs / 1000).toFixed(3));
    const durations = roundedDurations(phrases, totalSeconds);
    segments.forEach((segment, index) => { segment.duration = durations[index]; });
    scenes.forEach((scene, index) => { scene.duration = durations[index]; });
    spec.output = { ...(spec.output || {}), duration: totalSeconds };
    const cover = spec.cover && spec.cover.enabled === false ? 0 : Number(spec.cover && spec.cover.duration) > 0 ? Number(spec.cover.duration) : 1.5;
    spec.output.targetDuration = Number((totalSeconds + cover).toFixed(3));
    spec.timing = {
      contract: contractRelative,
      audioPath: contract.audio.path,
      audioSha256,
      durationMs,
      level: timingLevel
    };
    writeJson(specFile, spec);
    applied = true;
  }
  return {
    ok: true,
    contract: contractRelative,
    audio: contract.audio,
    timingLevel,
    phrases: phrases.length,
    alignment: contract.alignment,
    applied,
    warnings: fallbackBoundaries
      ? [`${fallbackBoundaries} phrase boundary/boundaries use authored-duration fallback; do not claim word-level alignment.`]
      : [],
    next: applied
      ? ['Run qcut explainer check <project> --stage spec --json, then qcut explainer materialize <project> --json.', 'Apply the existing provenance-rich timelineNarration object for this local audio; do not replace it with an unverified path-only object.']
      : ['Review narration-timing.json, then re-run with --apply to update production-spec durations.']
  };
}

module.exports = {
  TIMING_SCHEMA,
  budgetTargets,
  chooseBoundaries,
  lockNarrationTiming,
  silenceMidpointsMs
};
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