这个 Skill 能做什么，适合哪些场景？
capcut-cli 是一个独立、非官方的 MIT 开源 CLI，直接读写本地剪映/CapCut 草稿存储（draft_content.、draft_info. 等），全程 JSON 进出，不上传任何项目文件。它同时覆盖 CapCut 与剪映两个命名空间，v0.11 起可在多个时间线文件之间检测并同步修改。安装方式为 npm install -g capcut-cli，另提供零依赖的 TypeScript 库接口、JSONL 队列运行器（capcut serve）以及实验性零能力的 Wasm 只读工具。配套的 Agent Skill（skills/capcut-edit/SKILL.md）指导 AI 按渐进式披露检查草稿、把多步操作固化为确定性脚本，并遵守关闭工程、.bak 备份等写入不变量。
- 读取本地草稿 JSON，通过 info/tracks/materials/segments 等命令检查工程，默认输出 JSON，可加 -H 转表格
- 增删改视频/音频/文本轨道：trim、speed、volume、opacity、转场、蒙版、关键帧（ken-burns、淡入淡出动画）
- 字幕流程：Whisper 生成字幕（含卡拉OK逐词）、导入/导出 SRT/VTT、多语言草稿克隆翻译
- 批量写入走事务性 capcut batch，一次失败全不落盘；每次写入冲突检查并同步到所有可读时间线，附带 .bak 备份
- 长视频切条：cut 配合 detect-scenes、detect-silence、detect-retakes，产出竖屏短视频草稿
- quickstart/compile 从 JSON 规格创建可编辑草稿；render 输出低清 FFmpeg 代理预览（非最终成片）
- 短视频创作者想批量修正字幕文本、调音量或整体位移，而不愿在剪映界面里逐条点改
- 用 Claude 等 AI 代理搭自动化流水线的人，希望从原始录音一键生成带样式字幕的可编辑草稿，最后的发布点击留给人
- 需要把长访谈/纪录片切条成短视频的用户：用 cut、detect-silence、detect-retakes 找到可用片段并盖上标题和 CTA 文字
- 维护多语言视频账号的团队，用 translate 生成多语言草稿克隆、用 export-srt 导出双语字幕
- 跑 n8n/Make/Coze 自动化的运营，用 capcut serve 以 JSONL 任务流排队处理多个工程
- 想让 AI 动手前先做只读审查的用户，用 Wasm 的 inspect/diff/lint 三件套最小权限检查草稿
- 想直接得到最终成片导出的人：render 只是低清 FFmpeg 代理预览，真正的渲染仍在 CapCut/剪映内完成
- 没装 Node.js ≥18 的环境无法使用；caption 需要 Whisper、render 需要 FFmpeg，缺可选工具时对应命令不可用
- 期待官方支持或商业担保的团队：项目明确声明与 ByteDance 无关联，仅由赞助计划提供优先支持（$25/月起）
如何安装这个 Skill？
- 使用写入命令前必须先在剪映/CapCut 中关闭该工程，否则修改会被应用覆盖；恢复依赖 .bak（仅回滚一步）与 capcut restore。
- anim.sh 的效果缓存路径为 macOS 专属硬编码；在 Windows 上的跨平台克隆行为被文档自述为未验证。
- SKILL.md 标称 v0.11 而仓库已到 0.22.0，技能文档滞后于最新命令集；发布者身份未经 FollowSkills 验证。
- 写入有效 JSON 不代表效果会渲染（pitfalls.md 明确警告 alpha 关键帧无效），需在 CapCut 中打开视觉确认。
- 首次使用未本地缓存的动画/效果时，CapCut 需联网从官方目录拉取资源。
- --force-license 会绕过许可证拒绝逻辑，版权归用户自担；旧版（≤0.17.2）fixture 含设备标识符，务必使用最新版本。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js >= 18 (npm package capcut-cli)Optional: Whisper for captionOptional: FFmpeg/ffprobe for render and media metadata
通过 npm 全局安装（宿主环境需 Node ≥ 18）：
npm install -g capcut-cli不安装直接试用：
npx capcut-cli <command>从源码构建：
git clone https://github.com/renezander030/capcut-cli
cd capcut-cli
npm install
npm run build
npm link在 Agent Skills 客户端中，技能文件位于仓库的 skills/capcut-edit/SKILL.md，按宿主（如 Claude Code）的技能目录约定放入即可。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 把项目 my-first 里文本轨道所有字幕里的“替换词”批量改成“新词”，顺便把音量统一调到 0.5
- 用 clip.mp4 和 captions.srt 快速生成一个剪映草稿，然后导出 SRT 给我校对
- 把 interview.mp4 切成几条竖屏短视频，剪掉静音段，给每条盖上标题和订阅 CTA
- 给开场视频片段加淡入动画和 ken-burns 缩放平移关键帧
安装后先运行 capcut doctor 检查已装的媒体/转写能力，再用 capcut quickstart my-first --video clip.mp4 --srt captions.srt 生成第一个可编辑草稿。Skill 触发于用户提到 capcut、剪映、字幕或 draft_content. 等场景：代理先渐进式检查（info/doctor/diagnose/tracks/segments），多步操作必须走 scripts/ 下的参数化脚本而非即兴拼命令。值得记住的约定：写操作前先在 CapCut 中关闭工程；批量写入用 capcut batch（事务性，--continue-on-error 仅在用户明确接受部分提交时使用）；时间格式支持 1.5s、500ms、1:30 等；ID 取 UUID 前 6 位以上即可匹配；枚举（转场/蒙版/字体等）用 capcut enums --<category> 查询，加 --jianying 切换剪映命名空间；capcut describe 是代理 schema 的唯一权威来源。
这个 Skill 有哪些优点和局限？
- 零依赖、无需 API/MCP 服务器/HTTP 守护进程，直接操作本地草稿，结果在 CapCut 中仍是全轨道可编辑
- 写入事务化且自动 .bak 备份，v0.11 起同步多个时间线目标，降低草稿损坏风险
- 同时覆盖 CapCut 与剪映命名空间，中文用户可直接按剪映路径使用
- 为 AI 代理设计得很克制：确定性脚本约束、describe schema、只读 Wasm 工具提供最小权限模式
- 仅支持 macOS 与 Windows 的草稿路径，没有 Linux 版剪映/CapCut
- render 只是低清代理预览，最终渲染和发布仍需人工在 CapCut 内完成
- README 提醒 ≤0.17.2 的测试夹具含未脱敏设备标识，≤0.17.0 存在注入/临时文件问题，必须升级到 0.18.0+/0.17.1+
- 关键功能依赖可选工具：Whisper（转写）、FFmpeg（渲染/场景检测）、ANTHROPIC_API_KEY（翻译）
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| capcut-cli：剪映/CapCut 草稿命令行编辑器 本页 | 69 · 推荐 | ★ 891 | 11 天前 | MIT |
| AI 解说大师 Skill | 56 · 谨慎使用 | ★ 3.1k | 3 个月前 | MIT |
| OfficeCLI Morph-PPT 技能 | 60 · 推荐 | ★ 32k | 12 天前 | Apache-2.0 |
| Codex 图像生成技能（imagegen） ✓ OpenAI · 官方 | 56 · 谨慎使用 | ★ 129k | 11 天前 | Apache-2.0 |
| Video ShotCraft：电影感产品视频制作技能 | 61 · 推荐 | ★ 12k | 12 天前 | Apache-2.0 |
与同类 MCP 方案（如社区 capcut-mcp）不同，capcut-cli 走单二进制、无服务器路线，JSON 直接进出草稿存储；姊妹项目 draftcat（Go，MIT）延续同一无 API 设计，专攻受治理的 AI 流水线。
FollowSkills 如何评估这个 Skill？
证据显示安全设计较完整：所有写入有冲突检查、原子写、.bak 与滚动历史快照、capcut restore 回滚命令；--force-write 需用户明确接受；--dry-run 预览；批量写入默认事务性（一处失败不写入）；Wikimedia 下载按许可证分类并拒绝受限许可（除非 --force-license 明示担责）；非 Wikimedia URL 在网络调用前拒绝。扣分项：直接修改用户本地工程文件，写入权限较宽但已有备份缓解；动画脚本 anim.sh 写死 macOS 剪映缓存路径，跨平台行为未完全验证；发布者身份未验证。未发现红线风险。
仓库含真实 CI（Node 18/20/22 矩阵、build+test+lint）与 skills/capcut-edit/scripts/_test.sh 大量提交的冒烟测试，覆盖关键路径（动画、ken-burns、mask、text-ranges、import-srt、--jianying、Wikimedia 拒绝逻辑、许可证分类器），且测试断言 JSON 级效果并验证拒绝分支。扣分项：静态审查无法执行验证；测试对 '本地文件类型仅按扩展名检测' 使用假 jpg 通过，说明部分路径校验宽松；pitfalls.md 承认 Windows 效果缓存路径改写 '未验证'，macOS-only 的 EFFECT_CACHE_BASE 硬编码是可诊断性问题。
触发条件在 description 中明确（capcut、jianying、字幕、draft_content. 等关键词）；场景清晰（字幕、计时、速度、模板、长切短）；对剪映/中文命名空间支持好（--jianying、中文 slug 按成员名引用、中文文档、剪映优先快速上手）；核心功能完全本地，无海外服务依赖（Wikimedia 为可选输入）。扣分项：部分边界依赖未在文件内声明（如剪映加密版本由 README 外链文档）；效果目录缓存首次打开需联网拉取未作为环境限制充分强调。
文档分层好（SKILL.md→references→scripts→assets 渐进披露），MIT 许可证明确，package. 0.22.0 带版本与 CI、变更日志引用、免责声明和商标说明，维护响应有 issue 修复记录。扣分项：SKILL.md 自述 v0.11，与仓库 0.22.0 明显滞后，技能描述与最新命令集（compile/diagnose 等）之间存在版本不一致；schemas/资产引用的 `knossos-recon` 等私人项目名未向读者解释；赞助层级与功能绑定的治理模式可能造成文档/功能差异。
价值主张清晰：无 API、零运行时依赖、直接产出可在剪映/CapCut 中继续编辑的草稿，相较手工改 JSON 边际价值显著；测试断言输出结构正确（动画条目、关键帧、文本段）。静态审查上限内给 7：输出可直接可用性未经独立执行验证，且 pitfalls.md 自述 '写入 JSON 不等于渲染成功'，部分效果需视觉确认。
主材料可审计：提交的测试脚本、CI workflow、可复现的断言、pitfalls.md 中区分'已验证（CapCut macOS 8.5.0 beta）'与'未验证'的声明是事实/推断分离的良好示范。扣分项：静态审查无法独立复现执行；'经验证的 effect_id' 等关键主张依赖作者自述的第三方项目经验，交叉来源有限。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →