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/qiaocut-ir.md

View on GitHub
# QiaoCut IR

`QiaoCut IR` 是 qiaomu-cut 的中间格式。它把自然语言需求变成平台无关的视频工程语义,再交给素材 adapter 和渲染器执行。

## 最小结构

```json
{
  "schema": "qiaocut.ir.v0",
  "brief": "做一个 60 秒挖掘机英语启蒙视频",
  "workflow": {
    "id": "stock-story",
    "title": "免费素材故事片"
  },
  "output": {
    "durationSeconds": 60,
    "aspect": "9:16",
    "platform": "douyin",
    "deliverables": [
      "final.mp4",
      "assets-manifest.json",
      "license-report.md",
      "quality-report.json"
    ]
  },
  "sources": {
    "preferred": ["clipseek", "local", "imagegen", "listenhub"],
    "licenseRule": "Record sourcePage/license/attribution for every non-local asset."
  },
  "generation": {
    "narration": {
      "providerPriority": ["listenhub", "project-file", "macos-say"],
      "preferredVoiceName": "向阳乔木 v1.1",
      "resolutionRule": "Resolve an exact current speaker-name match; never silently substitute."
    },
    "images": {
      "styleStrategy": "content-derived",
      "visualBibleRequired": true,
      "visualBibleId": "vb-<16-char-digest>",
      "promptPrefix": "subject; medium; era; emotion; palette; lighting; composition",
      "negativePrompt": ["generic stock-photo look", "style drift", "anachronisms"]
    }
  },
  "scenes": [],
  "render": {
    "primary": "ffmpeg-full",
    "optional": ["html-renderer", "motion", "manim"]
  },
  "gates": ["doctor", "source manifest", "license report", "video verify"]
}
```

## Scene 字段

| 字段 | 说明 |
|---|---|
| `id` | 稳定 scene id,例如 `s01` |
| `purpose` | hook、context、development、turn、payoff、outro |
| `visual` | 画面描述或素材要求 |
| `sourceStrategy` | 使用哪些素材源:33tc、clipseek、local、imagegen、web-info |
| `motion` | 运镜或动效,例如 slow_push_in、parallax_photo |
| `transition` | 转场,例如 match_cut、whip_pan、soft_cut |
| `text` | 字幕、词卡、标题、lower third |
| `audio` | 原声、旁白、音乐、ducking、节奏点 |
| `verification` | 当前 scene 的检查要求 |

`explainer-social` 的 production spec 额外使用轻量认知契约:`cognitiveTask`(该拍唯一理解目标)、`primaryFocus`(真实组件焦点 ID)和 `visibleChange {kind,from,to}`。它们会进入 scene plan、HTML payload 与首尾双帧 review,不能只作为无人消费的描述字段。

## Asset 字段

| 字段 | 必需 | 说明 |
|---|---:|---|
| `source` | 是 | qiaomu-cut adapter 名称 |
| `provider` | 是 | 原始提供方,例如 pexels、pixabay、user-local-file |
| `mediaType` | 是 | video、photo、illustration、audio、html、svg、generated-image |
| `title` | 否 | 可读标题 |
| `sourcePage` | 外部素材必需 | 原始素材页 |
| `downloadUrl` | 可选 | 真实下载 URL,不应替代 sourcePage |
| `localPath` | 下载后必需 | 本地文件路径 |
| `licenseStatus` | 是 | verified、verify_at_provider、user_provided、ai_generated |
| `attribution` | 是 | 署名或来源说明 |

AI 旁白 provenance 额外记录 `speakerId`、`speakerName`、`speakerCatalogSha256`、`narrationTextSha256`、task/capture/model/credit;AI 图片记录 `visualBibleId`、实际 `prompt`、`seed`(provider 返回时)和 model。相同 SHA/provider/mediaType 只保留一个资产记录,但 `provenanceRuns` 保留重复生成任务与积分历史。

## 设计原则

- IR 不是最终渲染脚本,它是导演意图和可审计计划。
- 每个素材和事实都要能回溯。
- 渲染器可以替换,但 IR 的 scene/asset/audio/text 语义应该稳定。
- 缺证据时写 `missing evidence`,不要把计划伪装成已执行。
- 新增中文讲解音频默认使用 `qcut listenhub narration`:优先 ListenHub 的“向阳乔木 v1.1”显示名,只接受当前 speaker list 的唯一精确匹配,默认 MP3,自动入库后才进入带身份与内容 SHA 校验的 `narration.engine=file`。
- 生图风格从主题、受众、年代、情绪、平台和媒介推导为具体 visual bible ID/媒介/色板/光线/构图/prompt prefix;实际 prompt/seed/model 通过 ingest/fetch 回写,不能用与内容无关的通用风格词替代导演判断。
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