KB Cut Skills

KB Cut 是一组本地优先的视频剪辑 Skill，面向口播、访谈、知识分享等以人声表达为核心的视频内容，可通过 Codex 或其他兼容的 Agent 运行环境使用。

致敬开源项目

KB Cut 的诞生离不开以下三个优秀开源项目的启发，在此特别致敬：

dontbesilent2025/dbskill

dbskill 在开源价值观和 Skill 架构设计上给了我很大的启发。它所体现的简洁、可插拔式架构，是我心目中优秀 Skill 架构设计的代表，也直接影响了 KB Cut 将不同能力拆分为 kbcut-* Skill family 的方式。

helloianneo/ian-xiaohei-illustrations

Ian 的小黑 IP 帮助我启动了 AI 剪辑的 0-1。借助小黑 IP，我完成了许多 AI 科普类视频，也从 0-1 跑通了 AI 剪辑的完整流程，最终才有了今天的 KB Cut v1.0。

geekjourneyx/md2wechat-skill

杰尼的 md2wechat-skill 是一个优秀的 Skill，围绕微信公众号内容创作解决了许多实际问题。它启发我思考：围绕“自媒体剪辑”，还可以用 Skill 系统性地解决哪些问题，以及如何把这些能力沉淀成可复用的工作流。

本仓库目前包含两个 Skill：

• kbcut：主剪辑流程，负责本地转写、口播重剪、钩子选择、HyperFrames 动态字幕包装和封面交付。
• kbcut-style：frame.md 风格预设与字体角色解析。kbcut 在开始包装和封面设计前会调用它。

本项目采用可扩展的 kbcut-* Skill 集合结构。后续新增能力时，应创建新的同级目录，而不是把所有功能继续堆进主 Skill。例如：kbcut-vlog、kbcut-podcast 或 kbcut-export。

安装

将 Skill 目录复制或软链接到 Agent 运行环境使用的 skills 目录：

skills/
├── kbcut/
└── kbcut-style/

在 Codex 中，通常对应以下路径：

~/.codex/skills/kbcut
~/.codex/skills/kbcut-style

每个 Skill 的 SKILL.md、agents/ 元数据，以及它引用的 assets/、references/ 和 scripts/ 都必须保持在同一个目录中。

使用

完整剪辑任务从 kbcut 开始。它会在启动阶段自动解析 kbcut-style，然后要求确认画幅，再进入转写、剪辑和视觉包装流程。

使用流程

1. 准备拍摄完成的口播、访谈或知识分享视频，并将素材放在本地项目目录中。
2. 在豆包、WorkBuddy、Claude Code、Codex 等兼容的 Agent 环境中调用 kbcut，提交素材路径和剪辑目标。
3. kbcut 调用 kbcut-style，确定 frame.md 风格、字体角色与封面规范；确认输出画幅后，开始本地转写、内容重剪、钩子优化和视觉包装。
4. 在本地项目目录中获得口播优化版、指定画幅包装版、封面图片及可复核的工作文件。

kbcut-style 是完整流程中的视觉规范入口，不需要用户手动重复执行。需要浏览、解析或测试某个风格预设时，也可以单独调用它。

如果只需要列出或解析 frame.md 风格预设，可以直接使用 kbcut-style：

python3 kbcut-style/scripts/resolve_style.py --list
python3 kbcut-style/scripts/resolve_style.py founder-interview --project-root .

整个工作流以本地处理为原则。原始素材、转写结果、工作文件、预览和最终交付物都应保存在用户项目目录中，默认不上传源视频。

效果展示

以下图片展示了 KB Cut 在不同原始素材、内容主题和输出画幅下生成的封面效果。实际任务还会同时交付经过内容重剪和动态字幕包装的视频成片。

竖屏与 3:4 封面

横屏封面

实际发布效果

下面是使用 KB Cut 产出的视频与封面在内容平台中的实际展示效果。

仓库结构

kbcut/
├── SKILL.md
├── agents/openai.yaml
├── assets/frame.md
├── references/workflow.md
└── scripts/

kbcut-style/
├── SKILL.md
├── agents/openai.yaml
├── assets/frame-presets/
└── scripts/resolve_style.py

新增 Skill

创建新的顶层目录 kbcut-，并至少提供完整的 SKILL.md。根据需要添加同级的 agents/、assets/、references/ 和 scripts/ 目录。

每个 Skill 都应保持职责清晰，在 frontmatter 中写明触发描述；当新 Skill 对外发布后，同时更新本 README 中的 Skill 列表和仓库结构说明。

项目状态

这是原 starboom/kbcut 项目的重新初始化版本。项目已经从面向用户的“视频 AI 剪辑工具”代码仓库，转变为由多个 kbcut-* Skill 组成的本地视频创作 Skill 集合。

当前仓库中的 Skill 目录是项目的唯一事实来源。

技能特性

kbcut

• 本地 Whisper 转写，不默认上传视频或音频素材。
• 自动识别并处理气口、废话、重复表达、自我纠正和口误。
• 从完整口播内容中寻找更有力的开头钩子，并在保持原意的前提下前置。
• 使用 FFmpeg 生成口播优化版，保留人物原始色彩和自然表达节奏。
• 根据确认后的画幅制作 HyperFrames 动态字幕包装和独立封面。
• 在交付前复核转写、剪辑接缝、字幕位置、人物避让、色彩和输出规格。

kbcut-style

• 统一解析 KB Cut 使用的 frame.md 风格规范。
• 支持内置风格、项目级风格和用户显式提供的 frame.md。
• 管理动态字幕、封面设计、字体角色、颜色、间距和安全区规则。
• 支持将风格预设及其字体资源复制到具体剪辑项目。
• 为后续 kbcut-* Skill 提供统一的视觉规范入口。

FAB 介绍

Feature｜功能

KB Cut 将本地视频转写、口播内容重剪、钩子优化、动态字幕包装和封面制作组织成一套可调用的 Skill 工作流；kbcut-style 则把风格、字体和封面规则独立管理。

Advantage｜优势

它不是一个把所有功能写死在单一脚本里的剪辑工具，而是一个可以持续增加 kbcut-* 能力的 Skill family。内容处理与视觉风格分离，剪辑规则和设计规则都能被复用、替换和追溯；本地优先的工作方式也让素材、转写和交付文件留在用户自己的项目目录中。

Benefit｜收益

口播博主、知识创作者、访谈剪辑师和内容团队可以用统一入口快速完成从原始素材到可发布成片的流程，同时保留对剪辑决策、视觉风格、字体资源和最终文件的控制。随着新的 kbcut-* Skill 加入，同一套工作方式可以扩展到 vlog、播客、课程和其他视频类型。

联系与合作

如需加入付费技术答疑群，详情请扫码私信 oops0731111，备注 kbcut。

如有商务合作、企业定制化 AI 剪辑“黑灯工厂”、技术接入、内容团队工作流搭建或其他合作需求，请与作者联系。

飞书交流与合作群

如果你对 AI 剪辑感兴趣，想参与 KB Cut 交流，或者希望了解商务合作、企业定制化 AI 剪辑“黑灯工厂”，欢迎扫码加入飞书群。

许可证

本项目采用 CC BY-NC 4.0 许可证，版权归 starboom/kbcut 项目所有。

个人使用、学习、研究与非商业项目可以直接使用。 公开发布衍生作品时，请注明来源。 商业用途需要单独授权，请联系作者。