用途:本技能用于 FilmCraft CLI 的首次安装、摘要校验、版本检查与缺失运行时排障,并提供公开 CLI 入口;与同包技能按名称交接,单独安装即可使用,不读取兄弟目录。
主要能力:调用固定发布的 filmcraft-cli;自带 bootstrap.py 与 cli.py 入口;提供 workflow.py 和 commands.py 的 run 网关;可核对 JSON 回执中的可执行路径、摘要与版本;支持安装成功、命令目录存在与创作任务完成分别报告。
使用方式:定位当前 SKILL.md 的真实目录并设置为 SKILL_DIR,用户级可能在 ~/.agents/skills/filmcraft-cli-setup,项目级可能在 .agents/skills/filmcraft-cli-setup,以实际加载路径为准。安装与版本检查命令: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。CLI argv 在 -- 后。公开 workflow.py 和 commands.py run 必须显式提供 --read-root READ_DIRECTORY --write-root WRITE_DIRECTORY(可重复),根须为已存在的规范真实目录。--runtime-home 是安装维护目录,须位于独立明确授权的写入根。命令示例:python3 -I -B "$SKILL_DIR/scripts/commands.py" list --filter QUERY。
适用场景与限制:当前支持 macOS arm64、Python 3.11+;固定 CLI 安装到用户数据目录。不修改 PATH、不使用 sudo;版本损坏保留并报错,不自动升级。锁定制品摘要失败、损坏安装或不支持平台时停止。低层 Python 测试 API 不是公开授权入口。核验须查看真实保存工程、导出、尺寸及媒体解码,命令非零退出不算完成。缺失事实未提供。