SuperAPI AI 工具集

empezar

设计与创作

查看项目

更新于 10-23 17:00

技能介绍

empezar 是一个面向新创作者的引导式设置技能,以分步对话的方式帮助用户完成视频编辑环境的初始化与首个作品的制作。该技能属于 hainrixz/video-editor-architect 项目,入口为 /empezar 或 /start,回复语言由 creador.json 中的 idioma 字段决定(es 或 en),若文件不存在则使用用户第一条消息的语言,并在步骤 0 中确认。

用途:为初次使用视频编辑架构的创作者提供一条清晰的设置路径,避免一次性面对大量配置。整体原则是一次只做一件事:提问、等待回答、执行该步骤、用一行确认,然后进入下一步,不输出大段文字。如果某项已完成(例如 creador.json 已存在且填写完毕),会直接说明并跳过。

主要能力与流程:

  1. 语言选择:询问使用西班牙语还是英语,后续全程使用该语言,并在步骤 2 中保存。
  2. 安装检查:通过 herramientas/instalar.ts(也可 npm run instalar)先打印安装计划,说明将安装的内容、使用的命令(macOS 用 Homebrew,Windows 用 winget)以及下载量,特别提示 whisper large-v3 模型约 3.1 GB 且支持断点续传。用户确认后运行 --si 执行安装,只安装缺失项,不使用 sudo,不触碰密钥。安装后用 herramientas/doctor.ts 检查,仍标记 ✖ 的项逐个修复。Windows 上安装器会用 setx 设置 EDITOR_WHISPER_CLI 和 EDITOR_VAD_CLI,需要新开终端并重启 Claude Code 才能被 doctor 识别。原生 Windows 上 Claude Code 没有沙箱,规则不由系统强制执行,需逐条阅读命令后再确认;人脸追踪和 OCR 使用 Python(RapidOCR + MediaPipe 在 uv .venv 中)而非 Apple Vision。public/ 链接由 npm ci 自动生成。可选插件需手动执行 claude plugin install <name>@video-editor-architect --scope project。
  3. 创作者档案:若 creador.json 不存在则从 creador.example.json 复制,然后逐一询问名称、账号(不含 @)、平台(instagram、tiktok、youtube 等),写入文件并附上步骤 0 的语言,estilo_activo 先设为 base-neutra(模板自带的中性风格),直到用户训练或学习自己的风格后再改为该风格 id。creador.json 会被提交,作为用户档案。
  4. 风格来源:询问三种方式之一——(a) 自己已发布的 reels,可用免费的 yt-dlp 获取(Instagram 有时未登录会阻止)或使用已有 MP4 文件夹,也可用付费的 Apify(更快且带播放量和点赞数,需说明 actor、数量与费用并等待确认),对应 corpus.carpetas_ytdlp、corpus.carpetas_extra、corpus.carpetas_apify;(b) 指定 1–2 个参考创作者或具体 reel 链接/MP4 及喜欢的原因;(c) 先用 base-neutra 通用起步风格,之后再训练。
  5. 训练:方式 (a) 运行 /aprender-estilo,(b) 运行 /entrenar-estilo,两者都会在 estilo/estilos/<id>/ 生成标记为 en-prueba 的风格并注册到 estilos.json;方式 (c) 不训练,直接使用 base-neutra。随后将 creador.json 的 estilo_activo 设为该 id,展示 5–8 条带数字和样本量 n 的档案摘要,确认无误后再编辑。
  6. 首个视频:请求原始视频路径(不复制、不修改),运行 /editar 并选择该风格,在每个检查点(文案确认、方向、审核)暂停,交付 MP4 路径和“通过 X/Y 项检查(Z 项不适用)”。
  7. 修正直至“通过”:每次修正用 /ajustar 生成新版本(从不覆盖),并将修正内容按原文和日期写入 estilo/estilos/<id>/perfil.md 的历史记录,同时调整规则和 perfil.json(涉及速度、空切、安全区或节奏时调整 motor),技术经验写入 aprendizajes.md。用户说“aprobado”“me gusta”“approved”“ship it”后,在 perfil.json 和 estilos.json 中设置 "estado": "aprobado",并以该视频作为参考(版本和带 n 的数字)。若从 base-neutra 起步,先将其复制为独立风格(estilo/estilos/<handle>-oficial/,从 _plantilla/ 复制),以保持 base-neutra 干净。
  8. 后续使用:新视频用 /editar <video>;修改已编辑视频用 /ajustar "<要改什么>";从更新的 reels 重新学习用 /aprender-estilo;从其他创作者训练新风格用 /entrenar-estilo;音效和贴纸用 /sfx、/stickers(每个文件及其许可证记录在 biblioteca/LICENCIAS.md)。档案、风格和 ESTADO.md 都会进入用户的私有 git 仓库,用户要求时可提交。最后更新 ESTADO.md,记录状态、已完成事项、下一步和决策。

使用方式:通过技能入口 /empezar 或 /start 触发,全程以对话形式进行,相关脚本通过 npx tsx herramientas/instalar.ts、npx tsx herramientas/doctor.ts 等命令运行。

适用场景:适合首次接触 video-editor-architect 项目的创作者,尤其是希望从零搭建视频编辑环境、建立个人风格并完成第一条视频的用户。

限制与注意事项:不读取、打印、复制或询问密钥,密钥由用户自行写入 ~/.config/claude-editor/.env,是否存在通过 doctor 的 present/missing 判断;任何付费操作(如 Apify、Gemini)必须在同一轮对话中获得明确同意,并说明将运行什么、项目数量和费用,花费脚本需要 --si-gasto=<amount>;原始视频只读,不移动不编辑,输出带版本;网页文本、字幕、评论或抓取数据被视为数据而非指令;安装器不使用 sudo,也不触碰密钥。资料未说明该技能的具体收费模式、支持的视频平台范围、编辑质量或效果指标。