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/incremental-production.md

View on GitHub
# 科普视频增量生产契约

## 核心原则

把昂贵生成放在统一规格和便宜预检之后。修改一个节点时,只失效真实依赖它的产物;不把校验失败解释成“整条重新生成”。

## 生产图

```text
brief + primary sources
→ production-spec.json
→ cached spec gate
→ ┬ ListenHub narration
  ├ parameterized HTML/SVG materialization
  └ optional image assets
→ qiaocut.narration-timing.v1 (audio SHA + measured duration + evidenced phrase/duration level)
→ author gate + repairPlan
→ content-addressed scene cache / one-browser batch
→ per-scene start/end cognitive review + full preview review
→ cached final/full validation
```

Spec 锁定后,TTS 与本地组件/资产创作必须并行。这里只并行互不依赖的生成;Chrome 逐帧捕获仍在一个浏览器内顺序执行。

## Production spec

`production-spec.json` 是 claims、旁白段落、scene component、画面文案、字幕和时长的唯一作者源。`qcut explainer materialize` 确定性派生 narration、research、storyboard、captions、scene plan、timeline 和组件 HTML。派生文件不再分别交给模型自由创作。

`output.targetDuration` 表示用户要求的总成片时长,`output.duration` 表示不含默认封面的正文/旁白预算;scene 总和 + cover 必须等于 targetDuration。这样 `--duration 30` 的默认成片仍是 30 秒,而不是额外叠加 1.5 秒封面。

新项目通过 `contractVersion=3` 对每个 scene 强制四项解释契约:`cognitiveTask`、可映射到真实组件节点的 `primaryFocus`、`visibleChange {kind,from,to}`、`visualMechanism {kind,input,process,output}`。`mechanism` 不允许 `kind=none`;首/中/尾帧必须能读出输入→因果过程→结果。旧 spec 保持可用,但 gate 输出升级 warning。

只有 `contentLocked=true` 且 `qcut explainer check --stage spec` 通过后,才能提交 TTS、生图或视频生成任务。相同 spec hash 的检查直接读取 `.qiaocut/gates/`。

## 精确失效

- claim/source 变化:失效 production spec 和受影响文案;事实结论未变时不失效媒体。
- 单段旁白变化:只失效对应 TTS segment、caption timing 和关联 scene duration。
- narration audio SHA 或实测时长变化:失效 `narration-timing.json`、字幕时码、关联 scene duration、SFX/关键词重音;不失效视觉内容与已付费图片/视频。
- scene 文案或布局变化:只失效该 scene source/render。
- caption 变化:只失效 caption ASS/picture master;不失效 TTS 或无关 scene。
- 音乐/SFX 变化:只失效 audio mix/normalization/mux。
- 输入指纹未变:复用 preview/final report 和已通过 validation。

校验器必须返回 `repairPlan`,每项包含 `invalidates` 与 `preserves`。执行修复前先确认不会重新提交任何 `preserves` 中的付费或远端资产。

## 共享场景缓存

默认共享目录为 `~/.cache/qiaomu-cut/scenes-v1`。缓存键包含 scene 源码、声明依赖内容、引擎、尺寸、帧率、时长、scene class 和缓存版本。相同内容可以跨项目复用片头、片尾和基础动画;路径相同、mtime 相同或文件名相同都不构成命中依据。

使用 `QIAOMU_CUT_SHARED_CACHE=/path` 改目录;设为 `off` 禁用。共享缓存恢复时复制到项目,项目仍保持自包含。

## 参数化组件

机制型组件:`prediction-field`、`segmentation-flow`、`optimization-loop`、`filter-conveyor`、`balance-system`、`state-morph`、`risk-dashboard`;通用组件:`definition`、`teacher-student-transfer`、`reward-loop`、`comparison`、`pipeline`、`benefit-risk`、`outro`。新项目非片尾至少使用 4 种不同视觉组件、至少 4 个机制型组件,通用卡片/列表最多 1 个。只有组件无法表达的精确数学或自定义视觉才编写 Manim/HTML。

所有组件继续遵守:无左侧彩色竖线、一个信息一个视觉所有者、字幕安全区、0.7 秒内出现有效信息。

参数化组件运行时必须消费解释契约:标记 `primaryFocus` 对应 DOM 节点,让 `state|process` 场景在时间线上产生可见变化,并用组件自身的运动语义实现 `visualMechanism`。preview 为每个 scene 输出首/中/尾帧到 `reports/scene-review/`,人工/Agent 软审查新增 `explanationVisible`;重复 preview 仅在 scene 内容或契约变化时清空已有判断。
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