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/feedback-evolution.md

View on GitHub
# Feedback Evolution

目标:把用户明确反馈转成可追溯、可执行、可验证的 Skill 改进,同时避免一次性要求污染所有项目。

## 处理流程

1. 保存用户原话、日期、项目和可见证据。
2. 先修当前项目并用 preview、抽帧或报告确认结果。
3. 将反馈分类为 `project`、`workflow` 或 `global`。
4. 搜索现有规则,判断是新增、强化、替换还是冲突。
5. 能编码时修改参数、模板或测试;否则更新规则和验收清单。
6. 运行 Skill 校验、相关 smoke test 和真实任务回归。
7. 记录旧值、新值、证据及状态;冲突规则标记 `superseded`,不要删除历史语义。

## 偏好记录格式

```yaml
- id: stable-kebab-id
  date: YYYY-MM-DD
  userWords: 用户原话
  scope: project | workflow | global
  abstraction: 可复用偏好
  implementation: 参数、模板、脚本或验收项
  before: 旧行为
  after: 新行为
  evidence: 预览、抽帧、测试或报告路径
  status: active | superseded | project-only
```

## 当前偏好

```yaml
- id: english-mix-mobile-subtitles-readable
  date: 2026-07-19
  userWords: 屏幕顶部的字体太小了,下面的中文字体也小
  scope: workflow
  abstraction: 竖屏英语学习视频的顶部注释、来源和中文译文必须在手机尺寸直接可读,不能按桌面画布或 contact sheet 缩略图误判。
  implementation: 1080×1920 默认 English 76、Chinese 58 bold、Note 50 bold、Source 40;preview 后查看手机尺寸单帧。
  before: Chinese 46、Note 34、Source 25
  after: Chinese 58、Note 50、Source 40
  evidence: project-relative reports/subtitle-size-check.jpg plus typography smoke test
  status: active
- id: social-video-safe-zone-compliance
  date: 2026-07-19
  userWords: 搜索研究 TikTok 和抖音的安全区概念,我们的字幕显示位置和大小要遵循
  scope: workflow
  abstraction: 面向 TikTok/抖音的竖屏字幕必须避开顶部状态区、右侧操作栏和底部文案/CTA 区;安全区随设备、文案和组件变化时使用更保守交集并做平台预览。
  implementation: 1080×1920 共享安全矩形 x=120–900、y=240–1260;默认四层字幕基线 y=280/360/1120/1230;smoke test 锁定字号、边距与基线。
  before: 只验证字体可读性,没有平台 UI 几何约束;顶部 y=92/168,底部字幕基线约 y=1365/1482。
  after: 字幕全部进入共享安全矩形,并要求手机尺寸与平台 UI 预览。
  evidence: TikTok official In-Feed Standard LTR template plus Douyin/Jianying subtitle safe-area preview guidance
  status: active
- id: english-mix-larger-safe-type
  date: 2026-07-19
  userWords: 按这些规则重新生成视频,还有字号也要变大
  scope: workflow
  abstraction: 在不突破 TikTok/抖音共享安全区的前提下,英语学习视频优先使用更大的四层字幕,手机尺寸下应无需费力辨认。
  implementation: 1080×1920 默认 English 84、Chinese 66 bold、Note 56 bold、Source 46;保留 x=120–900、y=240–1260 安全矩形,并用 8 帧安全框 contact sheet 验证长短句。
  before: English 76、Chinese 58、Note 50、Source 40
  after: English 84、Chinese 66、Note 56、Source 46
  evidence: project-relative reports/safe-zone-large-text-contact.jpg plus typography smoke test
  status: active
- id: captions-outside-footage-no-source-label
  date: 2026-07-19
  userWords: 安全区只是参考,现在字幕都压在视频上了不好,顶部标题和下面的字幕都靠近视频区域,不要显示电影片段来源名
  scope: workflow
  abstraction: 安全区是平台 UI 风险参考;影视英语混剪应优先保持电影画面纯净,把标题和字幕放在画面上下相邻留白中,并默认隐藏片名来源。
  implementation: Note y≈560、English y≈1420、Chinese y≈1560;source 只进入 manifest/license report,字幕 JSON 仅在 showSource=true 时烧录。
  before: 为满足保守安全矩形,英文和中文压在电影画面内,来源名常驻显示。
  after: 三层文字与电影画面分离,来源默认隐藏,同时保留平台 UI 风险预览。
  evidence: project-relative reports/text-outside-footage-contact.jpg plus typography smoke test
  status: active
- id: branded-outro-template-diversity-complete-sentence-type
  date: 2026-07-19
  userWords: |
    1. 为什么都没有片尾,片尾也要加上类似片头的品牌,引导用户关注
    2. 开通和片尾的版式和动效太单一了,应该更加丰富,20个模版样式让用户选择,不选的时候用你觉得最合适的
    3. 视频截取的片段,经常没有实现完整的一句话就卡断了
    4. 顶部的标题字还是太小了
    5. 中文字体不够丰富好看
    优化skill
  scope: global
  abstraction: 品牌短视频必须有片尾关注 CTA,片头片尾需有可选择的多样模板;影视裁切必须保留完整句;移动端标题和中文排版应更醒目且有语义化字体主题。
  implementation: 20 套 brand template registry 与自动选型;强制 branded outro;previous/current/next 完整句裁切门;1080×1920 默认 English 88、Chinese 72、Title 76;分层字体主题与授权回退。
  before: 无强制片尾;片头样式单一;固定时间留白可能截断句子;English 84、Chinese 66、Title 56;单一字体。
  after: 片头+片尾成对生成且含品牌/账号/CTA;20 套可选模板;不完整句拒绝导出;English 88、Chinese 72、Title 76;标题/中英文字体可分层选择。
  evidence: scripts/brand_templates_smoke.js, scripts/sentence_boundary_smoke.js, scripts/bilingual_typography_smoke.js
  status: active
```

```yaml
- id: hide-template-metadata-snap-outro
  date: 2026-07-19
  userWords: 片尾不要用:“STYLE 06• 水墨留白”,不要把内部的风格信息暴露给外部,类似的逻辑都不要出现,还有片尾转场不要用缩放,更干脆直接有趣
  scope: global
  abstraction: 成片只呈现观众需要的品牌内容,制作模板和调试元数据不得外显;片尾节奏应短促有趣,避免缩放推拉。
  implementation: publicText 白名单测试;模板元数据仅留工程;片尾默认 snap-flash-pop 三段硬切且 motion=none。
  before: 片尾显示 STYLE 编号和中文风格名,并使用 pullBack/pushIn 等缩放运镜。
  after: 片尾只显示品牌、账号和 CTA;闪色 120 ms、品牌跳切 180 ms、CTA 定帧 2.3 s,全程无缩放。
  evidence: scripts/brand_templates_smoke.js and project outro frame review
  status: active
```

```yaml
- id: quality-over-count-no-duplicate-padding
  date: 2026-07-19
  userWords: 不要硬拼重复使用素材,如果不够10条就不够
  scope: global
  abstraction: 镜头目标数是上限,素材独立性和质量优先;不允许为凑数复用同一或近重复场景。
  implementation: 下载前多键去重、下载后 SHA-256/抽帧去重;报告 selected/target 与 padded:false;不足目标数正常成功。
  before: 选择器以达到 clipsPerVideo 为完成目标,不同 videoId 的相同下载文件可能漏过去重。
  after: 同源素材只保留最佳版本,不足 10 段按实际数量构建且不报失败。
  evidence: project reports/dedupe-report.json and source selection gate
  status: active
```

```yaml
- id: executable-explainer-social-pipeline
  date: 2026-07-21
  userWords: |
    explainer 负责 SVG、HTML、Manim 概念动画。
    social-short 负责 9:16 构图、强字幕、音效和短视频节奏。
    这两个是我的乔木cut skill中内置的功能吗?
    那优化到我们的skill中
  scope: global
  abstraction: Skill 对外声明的工作流应有可执行链路和真实测试证据;竖屏知识点视频应把概念动画与社交短视频包装合成一个工作流。
  implementation: 新增 explainer-social 路由;qcut scene render 支持断网 HTML/SVG 逐帧捕获和 Manim 导出归一化;ASS 增加 word-follow/karaoke/typewriter/pop/slide-up;timeline 增加 transition 与 soundEffects[];渲染报告记录转场与 SFX cues。
  before: explainer/social-short 主要是工作流标签和设计目标;HTML 只生成静态模板,Manim 只做存在性检查,timeline 只直接拼接图片/视频且无独立 SFX 轨。
  after: 可从 HTML/SVG/Manim 源文件生成可审查 MP4 中间资产,再用动态字幕、镜头转场、独立音效和 9:16 时间线完成可复现成片。
  evidence: scripts/kinetic_caption_smoke.js, scripts/timeline_features_smoke.js, scripts/scene_renderer_smoke.js, npm run release-check
  status: active
```

```yaml
- id: one-shot-explainer-autopilot-no-left-accent-blocks
  date: 2026-07-21
  userWords: |
    整个制作过程总结成一个自动化高速执行工作流内置到qiaomu-cut skill中,减少执行过程中的耗时和失败。未来我只需要说:制作一个科普视频:介绍LLM中的“RL”就能生成视频。
    还有组件生成时,不要用左侧颜色竖线的block块,这样显得很不专业,你优化下,以后避免,也写入我的审美偏好。
  scope: global
  abstraction: 一句话科普请求应自动进入内容核验、精确旁白、语义分镜、HTML/Manim 场景、预览审查和 final/full 的闭环;组件层级不得依赖左侧彩色竖线。
  implementation: 新增 qcut explainer init/check/render-scenes/preview/final;HTML/SVG 用 image2pipe 流式编码、按依赖增量顺序渲染;字幕坐标随 profile 缩放;默认向阳乔木 v1.1 MP3;author gate 检查一手来源、时长、字幕重复和左色条禁用模式;新增无左色条基础模板与审美偏好文档。
  before: Agent 手工创建目录、逐个运行 scene render,浏览器帧先写 PNG 导致高磁盘占用;默认 WAV 可能遇到封装不一致;preview 显式字幕坐标可能出界;卡片可使用左侧彩色竖线强调。
  after: 一句话进入 explainer-social autopilot;已有场景增量渲染,PNG 中间帧为零,付费旁白不自动重试,字幕跨 profile 保持位置,左侧彩色竖线在生成规则和 lint 中同时禁止。
  evidence: scripts/explainer_pipeline_smoke.js, scripts/scene_renderer_smoke.js, scripts/kinetic_caption_smoke.js, npm run release-check
  status: active
```

```yaml
- id: no-simultaneous-scene-caption-echo
  date: 2026-07-21
  userWords: 避免这种情况,画面显示和字幕完全一样,同时出现
  scope: global
  abstraction: 同一时间、同一信息只能有一个视觉所有者;画面组件与字幕不得逐字复读,否则信息层级混乱并浪费画布。
  implementation: explainer author gate 改为时间感知硬阻断;短中文阈值降为四个汉字,覆盖跨 HTML 标签和脚本动态注入文案,只比较与字幕时间重叠的 scene;preview 继续人工检查语义近似重复。
  before: 仅长度十个字符以上的静态整句会被发现,像“答案叫:知识蒸馏”这样的短句会漏检,而且不同镜头出现同句可能误报。
  after: 截图中的短句复读在 author 阶段直接失败;跨镜头同句不误报,字幕增加解释而画面只保留关键词时可以通过。
  evidence: scripts/explainer_pipeline_smoke.js short-split-copy-block, dynamic-copy-block, time-aware-copy-check
  status: active
```

```yaml
- id: incremental-generation-no-whole-video-regeneration
  date: 2026-07-21
  userWords: |
    我觉得合成速度不是瓶颈,而是前面的生成和复杂的校验检查重新生成。
    对,你优化下skill,还有上面的“场景使用内容哈希缓存跨项目复用片头、片尾、基础动画”,“多个 HTML/SVG 场景复用一个 Chrome 进程避免每个场景重复启动浏览器”,“TTS 等待期间并行创作 SVG/HTML 场景隐藏远端生成等待时间”这些也都优化考虑。
  scope: global
  abstraction: 视频提速的核心是让昂贵生成晚发生、互不依赖的生成并行发生、修改后只失效真实依赖节点,并复用已通过的复杂校验;不能把注意力只放在最终编码。
  implementation: 新增统一 production spec、缓存 spec gate、确定性参数化组件物化、结构化 repairPlan、单 Chrome HTML/SVG batch、跨项目 SHA-256 scene cache、preview/final 输入指纹与 validation 复用;Spec 锁定后并行 TTS 与本地组件/资产创作。
  before: narration/research/storyboard/captions/scenes 分别生成;author gate 在场景写完后才运行;场景按 mtime 判断且每个启动 Chrome;未变化 final 仍重新执行复杂校验。
  after: 慢生成前先锁定一份规格;相同规格和相同场景内容直接复用;五个 HTML 场景只启动一个 Chrome;校验失败只重做 invalidates 节点并保留 preserves 资产。
  evidence: scripts/explainer_pipeline_smoke.js and scripts/explainer_e2e_smoke.js
  status: active
```

```yaml
- id: mechanism-scenes-need-process-animation
  date: 2026-07-23
  userWords: 为什么画面里没有动画,更容易让人懂的设计?
  scope: workflow
  abstraction: explainer 的 mechanism/过程类场景(算法步骤、合并循环、切分过程)必须用随时间真实演化的过程动画,而不是静态卡片罗列步骤;陈述类场景(定义、对比、边界)才使用静态参数化组件。
  implementation: references/explainer-autopilot.md 第 7 步新增默认规则:mechanism 场景默认手写 HTML + window.__QIAOCUT_SET_TIME__ 逐帧动画(聚拢、合并、编号、状态转移),静态组件只承担陈述类场景。
  before: Tokenizer/BPE 项目 mechanism 场景用 reward-loop 静态卡片列出 4 个步骤,预览帧全程无变化,机制不可见。
  after: s02 字母聚拢成 token 再变编号、s03 BPE 四轮合并循环动画、s06 字母→碎片→编号→r 计数疑问的过程动画。
  evidence: Tokenizer-分词-讲解视频 scenes/s02_definition.html, scenes/s03_mechanism.html, scenes/s06_limits.html 与 preview 抽帧
  status: active
```

```yaml
- id: explainer-cover-first-frame-click-worthy
  date: 2026-07-23
  userWords: 为什么没有好看的首帧封面?让用户看封面好奇内容点击播放,这个优化沉淀到skill中;我觉得默认应该有封面
  scope: workflow
  abstraction: explainer 成片第 0 帧就是平台封面,必须默认是专门设计的封面镜头:悬念问句 + 核心视觉符号 + 品牌账号,一眼产生点击欲;不能把 hook 场景的空屏起始帧当封面。
  implementation: 代码级默认(v0.7+):defaultProductionSpec 带 spec.cover(enabled 默认 true,duration 1.5,title/highlight/teaser/brand/handle/cta 可配,enabled=false 可关闭);materialize 确定性生成 scenes/s00_cover.html(t=0 完整构图、动效仅点缀)、前置 scene-plan/timeline、偏移 captions 与 narration.start;author/scenes 门强制封面在首位,final 自动导出 cover.png 且 final 门强制其存在。references/explainer-autopilot.md 同步该契约。
  before: Tokenizer/BPE 项目首帧是 hook 场景 t=0 的近乎空屏帧,无标题、无视觉、无点击欲;封面只作为文档约定存在。
  after: 封面镜头含「strawberry 里有几个 r?」悬念大标题、str/aw/berry 切分视觉与编号、红圈圈出 rr、品牌与「一分钟看懂 BPE」,第 0 帧即为完整封面;脚手架对所有 explainer 项目默认生成封面。
  evidence: Tokenizer-分词-讲解视频 scenes/s00_cover.html, cover.png;scripts/explainer_pipeline_smoke.js default-cover-shot;scripts/explainer_e2e_smoke.js coverPngExported
  status: active
```

```yaml
- id: explainer-cognitive-contract-and-evidence
  date: 2026-07-24
  userWords: |
    你读取这个文档,看如何优化我们的 qiaomu cut skill。
    可以,执行吧。
  scope: workflow
  abstraction: explainer 的质量瓶颈不是继续增加框架,而是让每个 scene 只有一个认知任务、一个真实主焦点和一个可验证的状态变化;真实旁白只承诺有证据的 duration/phrase timing,preview 用首尾帧提前发现“元素在动但概念没讲清”的问题。
  implementation: production spec 保持 v1 兼容,通过 contractVersion=2 启用 cognitiveTask/primaryFocus/visibleChange;组件运行时消费焦点与 state/process 变化;mechanism 无变化硬阻断;preview 生成 reports/scene-review.json 与每场景首尾两帧软审查;新增 qcut explainer timing --audio ... --apply,记录音频 SHA-256、ffprobe 实测时长和 silencedetect 边界,证据不足时降级为 duration-level。
  before: scene 只有 purpose/component/文案/时长,mechanism 是否真的解释过程主要靠文字约定;preview 的代表帧偏全片后置;TTS 时长通过人工 ffprobe/silencedetect 修补且没有统一证据文件。
  after: 新项目在慢生成前锁定认知契约,运行时与 scene plan 都消费它;每个 scene 有可点击的首尾证据和四项 review;旁白时间有项目内哈希契约且不会把估算写成逐词对齐。
  evidence: scripts/explainer_pipeline_smoke.js, scripts/explainer_cognitive_timing_smoke.js, scripts/explainer_e2e_smoke.js
  status: active
```

```yaml
- id: english-mix-resilient-fast-path
  date: 2026-07-24
  userWords: 沉淀这次运行的经验教训,加速未来生成类似内容的速度,你仔细思考去完成这个任务
  scope: workflow
  abstraction: 影视英语混剪的速度取决于尽早淘汰不完整句和坏素材、复用已创建的付费任务、批量渲染重复版式,并在正式合成前一次性完成可视审片;不能把网络下载失败当成需要重新创建付费任务。
  implementation: 新增 qcut english-mix init/audit/review;subtitleWindow 支持 before/current/after 多 cue 并用 assertCompleteContext 在付费切片前阻断句首碎片;33tc 远程媒体下载启用有界重连并在已有 task ID 时提示 download 恢复;下载后审计音视频流、SHA-256 重复和 SRT 证据;卡片统一走 scene batch;review 自动生成 contact sheet 与最长英文字幕手机帧。
  before: 16 个初始付费任务全部遇到 TLS EOF,人工恢复;1 段只有音频、4 段从半句开始,最终创建 21 个任务且淘汰 5 个;7 张卡片逐次启动浏览器;审片图手工抽取。
  after: 付费前即拒绝半句候选;网络失败最多有界重试且优先复用 task ID;坏流和重复素材在时间线前统一淘汰;同构卡片一次 Chrome 会话批量渲染;预览后一个命令产出 8 帧总览和长字幕手机帧。
  evidence: scripts/sentence_boundary_smoke.js, scripts/ffmpeg_retry_shim_smoke.js, scripts/english_mix_smoke.js, project reports/retrospective-2026-07-24.md
  status: active
```

```yaml
- id: local-user-auto-33tc-credits
  date: 2026-07-24
  userWords: 以后不要问,自动使用积分完成
  scope: global
  abstraction: 当前本机用户已持续授权 33台词影视裁片自动使用积分;未来同类任务在时间范围和输出目录核对后直接执行,不再逐次询问,同时保留余额差额、task ID、失败恢复和版权审计。
  implementation: 公开 Skill 默认仍阻断付费动作;仅当权限为 0600 的本机私有 .qiaocut-local-preferences.json 明确设置 schema=qiaocut.local-preferences.v1、33tc.scope=local-user、autoUseCredits=true 时,wrapper 自动补入裸 --yes。显式 --yes=false 优先;每个项目记录前后余额与实际消耗;下载失败复用既有 task ID。
  before: 每个 33tc pick/cut 任务都要求当前轮再次确认积分。
  after: 当前本机用户的持续授权替代逐次询问,但不改变公开默认值、不影响其他用户、不取消范围审查和消费报告。
  evidence: 经典影视帅气舞蹈混剪/assets-manifest.json;scripts/security_smoke.js persistent authorization and insecure-file rejection
  status: active
```

```yaml
- id: english-mix-shot-breathing
  date: 2026-07-24
  userWords: 还有你剪辑的影视视频片段前后是不是都应该长点,留出空白或你加工下静音吧?避免突然开始和突然结束,让用户觉得很不舒服。
  scope: workflow
  abstraction: 影视英语混剪不仅要保证完整句,还要为每个原声片段保留可感知的入场和收尾呼吸;扩大源范围会带入下一句时,使用不破坏原片的静帧、静音和短音频淡入淡出。
  implementation: 新增 qcut english-mix pace --apply;默认首帧静音 180 ms、尾帧静音 320 ms、音频淡入 60 ms/淡出 120 ms;输出 assets/processed,不覆盖 assets/source;逐片段验证首尾低于 -60 dB;timeline 每个相邻 shot 使用 200 ms fade/audio acrossfade,并按 overlap 重算字幕。
  before: 素材完成句后直接硬切相邻片段,声画在边界瞬间启动/停止,用户听感突兀。
  after: 两端 500 ms 静音总量与 200 ms transition 重叠后,有效语音间默认约 300 ms 呼吸;声画同时软接,字幕同步 overlap;原片不变,参数可按真实环境声与语速调整。
  evidence: scripts/english_mix_smoke.js;四句地道英语影视混剪/reports/english-mix-pacing.json 与 transition-audit.json;render report transitions=22;final/full releaseReady=true
  status: superseded
- id: english-mix-fast-open-long-tail
  date: 2026-07-24
  userWords: |-
    你自己觉得处理的好吗?如果真的切断突兀,是不是应该让最后一帧多停留一点?
    还有开头半天没声音,是不是0帧封面就是封面,不应该停留这么久?
  scope: workflow
  abstraction: 英语影视混剪采用不对称节奏:第 0 帧已是完整封面,入口只留防爆音所需的极短静音,出口给观众明确的尾帧确认;转场不能吞掉大部分尾帧。任何首尾半句先按字幕 cue 裁掉,不能靠静帧或淡化掩饰。
  implementation: `english-mix pace` 支持 `trimStartMs/trimEndMs`;默认 60 ms 入场、500 ms 尾帧、40/160 ms 音频淡入淡出与 200 ms fade/acrossfade,完整尾帧约保留 300 ms。片头最长 700 ms、分组卡最长 600 ms、第一句原声最晚 1.2 秒,并要求第 0 帧完整可读。
  before: 上一版虽有 180/320 ms 首尾静帧和 200 ms 转场,但 intro 2.8 秒加分组卡 1.8 秒导致约 4.4 秒才出声;尾部 320 ms 又被转场吃掉 200 ms,完整尾帧只剩约 120 ms,仍显仓促;部分源片还带首尾残句。
  after: 当前成片第一句原声 0.968 秒出现;7 个开头残句和 5 个结尾残句已裁掉;60/500 ms 首尾、160 ms 淡出和 200 ms 转场使完整尾帧约 300 ms、有效语音间隔约 360 ms。
  evidence: 四句地道英语影视混剪/reports/english-mix-pacing.json;四句地道英语影视混剪/reports/transition-audit.json;四句地道英语影视混剪/reports/manual-review.md;scripts/english_mix_smoke.js
  status: superseded
- id: english-mix-cover-vs-intro-timing
  date: 2026-07-24
  userWords: 封面停留可以短,但介绍停留还是要稍微长点吧
  scope: workflow
  abstraction: 封面负责快速抓住注意力,短语介绍卡负责阅读与理解,两者不能绑定同一短时长;开场提速不应以牺牲表达和释义的可读时间为代价。
  implementation: 保持第 0 帧完整封面和 700 ms 片头;短语介绍卡默认改为 1200 ms、上限 1400 ms;第一句原声验收上限放宽到 1800 ms,并分别记录 cover/group-card/first-audio 三项时间。
  before: v0.9.2 将片头和分组介绍卡一起压到 700/600 ms,第一句原声 0.968 秒出现,但介绍卡阅读过快。
  after: 当前成片封面 700 ms、短语介绍卡 1200 ms,第一句原声实测 1.570 秒;介绍可读,同时仍远快于最初约 4.4 秒的无声开场。
  evidence: 四句地道英语影视混剪/reports/transition-audit.json;四句地道英语影视混剪/reports/review/opening-timing-v2.jpg;四句地道英语影视混剪/reports/render-report.json;scripts/english_mix_smoke.js
  status: superseded
- id: english-mix-two-second-intro-card
  date: 2026-07-24
  userWords: 介绍卡继续延长到2s?
  scope: workflow
  abstraction: 教学短语介绍卡需要完整的识别、阅读和理解时间;连续反馈表明 1.2 秒仍偏快,默认应以 2 秒为基准,同时继续保持封面短促。
  implementation: `english-mix init` 默认写入 700 ms 封面、2000 ms 短语介绍卡、2200 ms 介绍卡上限和 2600 ms 首句原声上限;预览必须用 `silencedetect` 实测首句时间。
  before: 介绍卡 1200 ms,第一句原声 1570 ms,仍略显仓促。
  after: 当前成片介绍卡 2000 ms,第一句原声实测 2370 ms;封面仍为 700 ms,未回到最初 4.4 秒的拖沓开场。
  evidence: 四句地道英语影视混剪/reports/transition-audit.json;四句地道英语影视混剪/reports/review/opening-timing-v3.jpg;四句地道英语影视混剪/reports/render-report.json;scripts/english_mix_smoke.js
  status: active
```

```yaml
- id: benefit-risk-two-column-grid-fix
  date: 2026-07-23
  userWords: (preview 人工审帧发现的组件缺陷,随「更容易让人懂的设计」反馈一并修复)
  scope: global
  abstraction: benefit-risk 组件只渲染左右两张卡,模板 grid 却声明三列(1fr auto 1fr),右卡落入 auto 中列把左卡挤成竖排单字;两卡组件必须列数与卡片数一致。
  implementation: 模板 base.css 拆分为两条规则:.component-comparison/.component-teacher-student-transfer 保持 1fr auto 1fr(三列,含中间 VS/箭头),.component-benefit-risk 独立为 1fr 1fr(两列两卡);曾误把三者合并选择器整体改成 1fr 1fr,导致 comparison 的 VS 挤到第二列、右卡掉到第二行,已在 16:9 迁移审帧时发现并回正。
  before: RLHF s06 左卡「把人类偏好变成分数」一字一行竖排;Tokenizer s06 曾靠加长文案偶然规避。
  after: benefit-risk 两卡等宽横排;comparison 三列横排 VS 居中。
  evidence: RLHF-讲解视频 _preview_frames/f_74.png(修复前)与 g_74.png(修复后)
  status: active
```

```yaml
- id: every-scene-needs-living-visual
  date: 2026-07-25
  userWords: 动画示意很少啊,可以调用生图,调用更多svg生图,让讲讲更生动
  scope: workflow
  abstraction: explainer 每个场景默认要有“活的”视觉:机制/过程用手写 HTML/SVG 逐帧动画,证据用动态图表(柱状图、仪表盘、排序),概念用示意动画;生图插画作补充(注意 ListenHub 生图走 OAuth,TTS 的 openapi key 不通)。纯文字卡片场景全片最多 1 个(hook 或 outro 除外需有品牌视觉)。
  implementation: references/explainer-autopilot.md 第 7 步规则升级为:mechanism 必须过程动画;definition/benefits/limits 默认配一个动态示意图(选择、漏斗、仪表盘、膨胀、盖章等),comparison 默认动态图表(柱状/奖牌/翻转);生图需 listenhub OAuth 登录,未登录视为 blocker 不得静默跳过不说。
  before: RLHF 初版 7 个场景只有 s03 有动画,其余为静态文字卡。
  after: s01 聊天打分、s02 写不出公式→人选答案、s04 柱状图奖牌移动、s05 漏斗+仪表盘、s06 气泡膨胀+质疑章全部动画化。
  evidence: RLHF-讲解视频 scenes/s01_hook.html、s02_definition.html、s04_modern_practice.html、s05_benefits.html、s06_limits.html 与 _preview_frames/v_*.png、w_*.png
  status: active
```

```yaml
- id: explainer-outro-spoken-brand-cta
  date: 2026-07-25
  userWords: |
    结尾为什么没有引导关注向阳乔木
    优化skill,避免忘掉口播的片尾
  scope: global
  abstraction: explainer/品牌科普片尾必须同时具备口播关注引导和画面品牌 CTA;不能只剩知识收束,也不能只在角落放小字。
  implementation: |
    production-spec gate 硬规则:
    - outro-spoken-brand-cta:outro 旁白必须含「向阳乔木」且含「关注」或「@vista8」
    - outro-visual-brand-cta:outro 画面必须同期出现品牌 CTA
    文档:SKILL.md 一句话科普/质量门、references/explainer-autopilot.md 第 4/10 步、brand-card-templates.md。
    推荐口播句式:「……结论。关注向阳乔木,继续拆解大模型关键词。」
    画面可用 snap-flash-pop 或独立 s08_brand 定帧。
  before: 片尾规范偏重视觉品牌卡;Agent 常把 outro 写成纯认知收束,口播不提关注,画面只有角落小字。
  after: 付费 TTS 前 spec 门阻断无口播/无画面 CTA 的 outro;preview 必须抽听抽看最后几秒。
  evidence: scripts/explainer_spec.js gates + scripts/explainer_pipeline_smoke.js negative/positive cases + Pretraining 16x9 brand frames
  status: active
```

```yaml
- id: explainer-mechanism-native-visual-diversity
  date: 2026-07-30
  userWords: 为什么我们生成出来的动态画面介绍,模式总是很单一,也没有有趣的能解释原理的动效,如何优化skill解决,你重新生成
  scope: workflow
  abstraction: explainer 的动态不能只是同一套卡片在淡入、缩放和点亮;每个原理应使用与其因果结构匹配的视觉语法,并在首/中/尾帧中明确呈现输入、过程和结果。
  implementation: 新项目升级为 contractVersion=3;scene 强制 visualMechanism {kind,input,process,output};新增 prediction-field、segmentation-flow、optimization-loop、filter-conveyor、balance-system、state-morph、risk-dashboard 七类机制组件;spec gate 强制非片尾至少 4 种不同组件、至少 4 个机制型组件、通用卡片最多 1 个;scene review 新增 explanationVisible。
  before: 既有规则虽然写着“mechanism 需要过程动画”和“每场景需要活的视觉”,但默认组件仍只有 definition/reward-loop/pipeline/comparison 等卡片结构,门控只验证帧差和状态变化,导致“卡片在动但原理没解释”。
  after: 概率竞争、Token 切分、前向/损失/梯度回流、数据去重过滤、参数×数据×算力平衡、能力跃迁和风险边界各用不同运动语义;单一模板在付费生成前即被阻断。
  evidence: scripts/component_motion_smoke.js, scripts/explainer_pipeline_smoke.js, scripts/explainer_cognitive_timing_smoke.js, 大模型预训练-机制动画版/reports/scene-review.json, 大模型预训练-机制动画版/reports/render-report.json
  status: active
```

```yaml
- id: chinese-video-default-exact-qiaomu-voice
  date: 2026-08-10
  userWords: 优化skill,默认用向阳乔木v1.1音色,你怎么记不住,写入永久记忆,视频也重新生成
  scope: global
  abstraction: 中文讲解视频默认旁白必须是 ListenHub 精确音色“向阳乔木 v1.1”;这是成品契约,不是可在缺少积分授权时静默降级的建议。
  implementation: explainer-plan 保留 provider=listenhub、voiceName=向阳乔木 v1.1、exactMatchRequired=true;author gate 在 timing 锁定后校验 timeline narration 的 provider、精确 speakerName、assetId、speakerId 和 narrationTextSha256;不符合时阻断 preview 并要求重新生成。文档同步禁止使用 macOS say/Tingting 静默替代。
  before: 北京大学介绍视频因本机没有 ListenHub 持续积分授权,Agent 自行使用 macOS Tingting 音色交付,虽然 Skill 文字已声明默认音色,却没有防降级硬门。
  after: 缺少授权时任务停在付费门请求授权;只有精确的向阳乔木 v1.1 及完整 ListenHub 来源能通过 author gate。
  evidence: scripts/explainer_cognitive_timing_smoke.js default-voice-contract-gate;北京大学介绍 ListenHub 旁白重生成、preview 和 final/full 报告
  status: active
```

```yaml
- id: real-world-image-evidence-and-relation-driven-visuals
  date: 2026-08-10
  userWords: 为什么没有检索相关图片放进去,而且动态图表都那么单调,你研究乔木chart report skill 吸收学习
  scope: workflow
  abstraction: 真实人物、地点、机构、品牌和历史题材不能被当成纯抽象科普;必须先建立图片证据账本,再从每幕要回答的问题与真实信息关系选择照片、时间线、比较、构成、分布、流程、层级、网络或地理。视觉趣味来自语义匹配和证据,不来自重复卡片、装饰性百分比或伪仪表盘。
  implementation: 新项目升级为 contractVersion=4;新增 visualEvidence 图片检索与权利门、scene.visualQuestion/visualForm/visualRelation 语义契约,真实题材至少 2 条检索词、3 张已下载且来源/署名/许可明确的图片、2 个照片/混合场景和 3 种语义关系;新增 evidence-photo、timeline-story、relationship-map 组件;事实/计算图表强制来源、单位、编码,真实题材的无来源 prediction-field/balance-system/risk-dashboard 在 spec 门阻断。规则吸收自 qiaomu-chart-report 的“读者问题→证据账本→关系→视觉语法”流程。
  before: 北京大学介绍被自动套成纯 motion graphic;没有检索校景、校门和历史建筑照片,学科与风险场景使用无来源的 82/86/78 等装饰性数值,组件名虽然不同,信息关系和运动语法仍然单一。
  after: 当前视频使用可溯源的北大西门、未名湖/博雅塔和红楼图片,历史用时间线、学科与校园实践用关系网络,删除全部无来源百分比;未来同类真实题材在付费 TTS 前即被图片证据与视觉关系门阻断。
  evidence: scripts/explainer_spec.js contractVersion=4 gates;assets/explainer-social/component-runtime.js;scripts/explainer_pipeline_smoke.js;北京大学介绍 visualEvidence 与 final/full 报告
  status: active
```

```yaml
- id: composition-driven-photo-motion
  date: 2026-08-10
  userWords: |-
    为什么图片永远是缩放动效?
    不要给图片加这种sb缩放
  scope: global
  abstraction: 所有静态图片镜头禁止缩放,包括图片元素本身以及承载图片的外层焦点脉冲。图片运动只能来自定帧、遮罩揭幕、object-position 平移或焦点变化;没有理由移动时直接定帧。
  implementation: 新项目 contractVersion=5 的 scene.evidence-photo 强制声明 photoMotion,仅允许 hold、reveal-left、reveal-right、pan-up、pan-down、rack-focus;push-in 触发 photo-scale-forbidden 硬门。运行时删除图片 scale 分支,并让 focus-photo 跳过通用 spotlight/pulse scale。
  before: 第一轮只去掉图片元素默认缩放,却仍保留可选 push-in,且通用焦点强调继续把 focus-photo 外层容器放大约 3%,视觉上仍像图片缩放。
  after: 北京大学介绍使用西门从左揭幕、红楼由虚到实、未名湖沿纵向浏览;图片元素和外层容器均无 scale,Skill 也不再提供 push-in 选项。
  evidence: assets/explainer-social/component-runtime.js;scripts/explainer_spec.js contractVersion=5 gates;scripts/component_motion_smoke.js;北京大学介绍 final/full 报告
  status: active
```

```yaml
- id: frame-zero-cover-and-thumbnail
  date: 2026-09-28
  userWords: 对于视频来说需要封面,不能让开头是黑色的,你搜索调研 Youtube 上最火,点击最高的封面,还有总结出封面设计方法论。给视频加上封面,融到视频开头。这个方法也需要写入 qiaomu cut skill 中
  scope: global
  abstraction: 每支非循环成片都以封面开场,封面就是第 0 帧和缩略图;先定承诺再画,一个焦点、≤ 6 字、明度对比、避开时长徽标、168 px 可读;定帧 ≤ 0.7 s 后在拍点退场,正片前 5 秒兑现封面。
  implementation: references/cover-thumbnail-method.md;scripts/cover.js(qcut cover check|export);motion init 以两拍 s00 封面开场并生成 brief.cover;motion check 的 cover-missing/cover-unwritten 硬门;motion probe 第 0 帧平均亮度 ≥ 28 硬门并阻断 final;qcut motion cover 多变体缩略图;scripts/cover_smoke.js。
  before: motion 片从黑底逐词钩子开场,第 0 帧全黑,没有缩略图交付。
  after: 乔木 Home 宣传片第 0 帧是「告别空白页」前后对比封面(定帧 0.7 s,1.0 s 强拍接钩子),另交付 3 个缩略图变体(1280×720 JPG + 2x 母版 + 360/168 预览)。
  evidence: qiaomu-home-promo/reports/motion-cover.json、reports/motion-probe.json(cover.notBlack)、scripts/cover_smoke.js、scripts/motion_studio_smoke.js
  status: active
```

```yaml
- id: one-film-one-concept
  date: 2026-09-29
  userWords: 为啥风格都一样啊,能不能发挥想象力,参考苹果等大厂的宣传片重新写不同的脚本画面运镜重新生成,每个风格和配乐都不一样,让人看来就想马上安装使用
  scope: global
  abstraction: 同一批多支宣传片必须是独立创意——不同的原型、参考广告、机关、镜头语言、配乐和字体;共用骨架只换皮肤是失败。先选创意再写代码,先卖情绪/结果再讲功能。
  implementation: references/ad-concept-library.md(原型库+差异矩阵);brief.concept 字段与 concept-unwritten 硬门;qcut motion diversity(same-archetype/same-music/same-structure/same-reference 阻断,close-tempo/similar-palette/same-type/same-duration 警告);scripts/concept_smoke.js。
  before: 电台/RSS/Reader/Agent 四支共用同一份 promo-kit 骨架(封面→黑底钩子→圆形展开→四个功能段→信任句→片尾),只换配色、截图和文案,配乐同一套生成器。
  after: 四支各自独立:Reader 文学宣言(钢琴华尔兹)、RSS 动态字体(808 强节奏)、电台剪影舞蹈(放克 house)、Agent 空间飞行(无鼓氛围);diversity 检查通过。
  evidence: qiaomu-plugin-promos/v2/*/motion-brief.json 的 concept;v2/reports-diversity.json;scripts/concept_smoke.js
  status: active
```

## 提升门槛

- 用户明确要求“以后都这样”或“改进 Skill”:可直接提升到对应 workflow/global。
- 重复两次以上且方向一致:提升为 workflow 默认。
- 单次审美偏好且可能依赖内容:保留 project-only,等待更多证据。
- 可读性、安全、版权、数据保护问题:一次有效证据即可升级,但必须验证没有引入新风险。
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