1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | baocut |
| 作者/维护者 | JimLiu（个人开发者） |
| 来源链接 | https://github.com/JimLiu/baocut |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 320（数据来自 GitHub API） |
| Forks | 19（数据来自 GitHub API） |
| 最新版本 | SKILL 版本 0.9.7，要求 BaoCut App ≥ 0.8.3（frontmatter 自带版本契约） |
| 安装方式 | npx skills add JimLiu/baocut -g -a claude-code codex -y，另需从 baocut.app 安装免费的 BaoCut Mac App |
2. 功能介绍与亮点
baocut 让 Claude Code、Codex 等 agent 用自然语言驱动本地 Mac 应用 BaoCut——从命令行完成转写、字幕翻译校对、说话人识别、口播粗剪与 B-roll 插入，并导出到剪映、Premiere Pro、DaVinci Resolve、Final Cut Pro、Shotcut、Kdenlive 等主流剪辑软件的可编辑工程文件。
亮点：
- 本地优先：音视频处理在用户自己的 Mac 上完成，BaoCut App 官方明确不上传素材到云端。
- agent 即编排者：LLM 推理阶段（分段/润色/翻译/对齐）由调用它的 agent 亲自完成，skill 本身不内置第三方模型调用，也不需要额外 API key。
- 版本契约：SKILL.md frontmatter 显式声明技能版本与最低 App 版本，不匹配时 CLI 直接报错并给出更新指引。
- 任务路由表完整：SKILL.md 按转写、粗剪、字幕样式、导出等场景分别指向对应参考文档，文档工程质量高。
- 快速响应式维护：多个用户报告的具体 bug（如默认模型未同步、长视频对齐超时）都在后续版本中确认修复。
3. 适用场景
所属分类：集成与工作流自动化（skill 本身不直接产出剪辑成果，而是把 agent 接入本地 BaoCut App 的命令行来驱动其能力）
适合需要给播客/口播视频批量加字幕、把英文素材翻译成中文字幕、或做口播粗剪后导出到专业剪辑软件继续精修的内容创作者、视频剪辑师和自媒体团队；尤其适合已经在用 Claude Code/Codex 处理日常工作、希望用自然语言而非鼠标点选完成转写字幕流程的用户。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 明确点名，安装命令直接为 Claude Code 建立软链接，可用
/baocut唤起。 - Codex：原生支持，README 与安装脚本同样明确点名。
- OpenClaw / Hermes Agent：未验证，但 skill 遵循 skills.sh 通用规范，README 声明“适配任何 skills.sh 兼容 agent”，理论上可安装，具体表现未经证实。
- 硬性前提：仅支持 macOS（要求 Apple Silicon、macOS 15 及以上），且必须额外安装免费的 BaoCut Mac App，不能在 Linux/Windows 上运行。
5. 推荐理由
它把一个专业、免费、纯本地的视频转写剪辑工具接进了 agent 的自然语言工作流：不用打开桌面软件点菜单，直接让 Claude Code 说一句“把这条视频转写并翻译成中文字幕”就能跑通转写、翻译、粗剪、多软件导出的完整链路，同时保留了版本契约与详尽参考文档这类专业软件工程细节。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 仓库约三周内涨到 320 Stars、19 Forks（数据来自 GitHub API），近期 issue 区能看到至少 9 个不同用户名各自提交过具体使用中的 bug 报告，显示出真实的多用户日常使用，但尚未形成大规模多平台讨论。 |
| 可用性 | 8 | 安装分两步（npx skills add 装 skill + 官网装免费的 BaoCut App），文档极为详尽（主 SKILL.md 加按任务拆分的多份参考文档），版本契约保证 skill 与 App 版本不错位；仅支持 macOS + Apple Silicon 是硬性限制。 |
| 安全性 | 9 | 详见下方检查清单，各项均无异常。 |
安全检查清单：
- shell 命令及权限范围：CLI 解析脚本仅做路径查找与转发（
resolve到已安装 App 内的可执行文件），核验后逐行审阅未见破坏性操作或权限扩张。 - 运行时联网外发：BaoCut App 官方明确音视频处理在本机完成、不上传素材；LLM 推理阶段由调用方 agent 自己执行，skill 代码本身不发起隐藏的第三方网络请求。
- API key / 凭据：不需要任何密钥，无需注册账号。
- 可疑指令：审阅 CLI 解析脚本与 SKILL.md 摘录未发现隐蔽指令或混淆代码。
- 作者信誉：个人开发者，但对社区 bug 报告响应迅速（多起问题从报告到修复间隔很短），项目公开透明。
- License：MIT，明确无歧义。
- 维护时间：近日仍有提交与版本发布，属活跃维护。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 baocut 的差异 |
|---|---|---|
| Descript | 云端全功能“编辑文本即编辑视频”工具，订阅制约每月 16–50 美元 | 需要付费订阅且素材上传云端处理；baocut 依托免费本地 App，且可被 agent 用自然语言直接调用，无需在网页界面操作。 |
| MacWhisper | 本地 Mac 端 AI 转写工具，一次性付费或订阅 | 只做转写，不支持翻译、字幕样式、粗剪或导出到专业剪辑软件；baocut 覆盖转写到多软件导出的完整链路。 |
| 剪映/CapCut 内置字幕 | 剪辑软件自带的一键 AI 字幕功能 | 依赖在软件内手动操作，不支持被 agent 编排调用；baocut 本身还能把处理结果导出为剪映可编辑工程，供用户在图形界面继续精修。 |
8. 用户评价
- GitHub issue #16（用户 Gogoworks）报告“baocut app 改变默认模型之后,baocut skill 未能同步修改”，附带截图说明具体测试环境；维护者 JimLiu 回复后很快确认修复，体现真实使用反馈与快速响应。
- issue 区还能看到多位用户（如 deletexiumu、zhongjjm-design、cainiaodidi 等）分别报告长视频对齐超时、导出崩溃、弹窗未居中等具体问题，反映出多样化的真实日常使用。 该技能目前在 Reddit 等社交平台尚无具名讨论记录。
9. 其他补充
版本契约机制（SKILL 版本 + minAppVersion）是该项目专门设计的工程细节，用于在 App 与 skill 各自迭代时避免功能错位，属于该类“driver 型”技能中较少见的严谨做法。
10. 安装使用方式
- 一键安装（推荐）：
npx skills add JimLiu/baocut -g -a claude-code codex -y，会把 skill 装到~/.agents/skills/baocut并为 Claude Code、Codex 建立软链接。 - 手动安装（无需 Node.js）：克隆仓库后手动建立软链接到对应 agent 的 skills 目录（README 提供了具体命令）。
- 前提条件：需先从 baocut.app 下载安装免费的 BaoCut Mac App（要求 macOS 15 及以上、Apple Silicon）。
- 使用方式：安装完成后直接用自然语言提问，例如“转写并翻译 talk.mp4 的字幕为中文”，或输入
/baocut唤起技能；无需重启终端或 agent。
11. 注意事项
- 仅支持 macOS（Apple Silicon，macOS 15 及以上），无法在 Linux/Windows 使用。
- 依赖用户额外安装一个独立的桌面 App（虽然免费），不是纯 skill 内自包含的方案。
- 由单人维护，长期可持续性有待观察；不过近期迭代速度与 issue 响应速度都较快。
- 除 Claude Code 与 Codex 外，其他 agent 生态中的实际兼容表现尚未验证。