用途:FilmCraft 时间线剪辑技能负责排序、裁切、移动镜头,组织轨道与单镜头修改,与同包技能按名称交接,单独安装即可使用,不读取兄弟目录。调用固定发布的 filmcraft-cli,保留原生编辑工程。
主要能力:提供 describe、exec、run 等命令入口,支持原生组合与源工程修订,使用自带 scripts/workflow.py 与 examples 模板;commands.py 原生 ticks 必须为精确 JSON 整数,每秒 254016000000 ticks。
使用方式:先设置 SKILL_DIR 为实际加载的 SKILL.md 所在目录,再执行安装与版本检查: python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" python3 -I -B "$SKILL_DIR/scripts/cli.py" -- --version python3 -I -B "$SKILL_DIR/scripts/cli.py" -- commands --json 公开 workflow.py 和 commands.py run 必须显式提供 --read-root 与 --write-root(可重复),根须为已存在、经用户或宿主授权的规范真实目录。--runtime-home 为安装维护目录,须位于独立授权的写入根。
适用场景:需要排序、裁切、移动镜头,组织轨道与单镜头修改的本地 headless 剪辑任务;macOS headless 支持根隔离执行。
限制:当前支持 macOS arm64、Python 3.11+;低层 Python 测试 API 不是公开授权入口;无法确认隔离的外部 bridge 明确拒绝;命令非零退出不算完成,超时结果标 unknown,不能自动重放编辑;不提供虚构登录接口,本地 headless 不要求云账户;完整 GUI、跨编辑器保真与创作质量按实际证据陈述。安装失败可交给 filmcraft-cli-setup,完整任务路由交给 filmcraft-use;缺少技能时使用 npx skills add full-aigc-skills/filmcraft-skills --skill <skill-name>。