FilmCraft 工程与序列

本技能负责创建、打开、保存 fcproj 和组织序列、素材箱。与同包技能按名称交接，单独安装即可使用，不读取兄弟目录。调用固定发布的 filmcraft-cli，保留原生编辑工程。

可信目录权限

旧 cli.py 原生转发的工程读取与编辑也需要在 -- 前提供独立根参数；仅精确版本／帮助／无工程目录查询兼容旧调用。模型下载须单独使用 --model-maintenance，见本技能 执行权限。

公开 workflow.py 和 commands.py run 必须显式提供 --read-root READ_DIRECTORY --write-root WRITE_DIRECTORY（可重复）；根须为已存在的规范真实目录，来自用户／宿主授权，不能从计划或素材元数据推导。计划、素材及源交付须位于读取根，交付及其父目录须位于写入根。--runtime-home 是安装维护目录，须位于独立明确授权的写入根；编辑原生进程始终禁止修改该缓存、技能、登记输入和源工程。当前根隔离执行支持macOS headless；桌面入口须同时隔离本次拥有的签名应用和MCP客户端，只开放分配的loopback控制端口。无法确认隔离的外部bridge明确拒绝。低层Python测试API不是公开授权入口。详细边界见 执行权限。

输入与交付

输入为用户已确认的任务、素材、工程或对象、输出目录与修改范围；需要现有工程时先核对摘要。返回实际 CLI 结果、保存后的原生工程、需要的派生输出与核验记录。安装成功、命令目录存在与创作任务完成分别报告。

首次使用与公共入口

定位当前 SKILL.md 的真实目录。当前支持 macOS arm64、Python 3.11+；固定 CLI 安装到用户数据目录。已有任务授权覆盖必要依赖时直接执行本技能安装器，不另造批准流程。

将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在目录（绝对路径）。用户级安装可能位于 ~/.agents/skills/filmcraft-cli-project，项目级可能位于 .agents/skills/filmcraft-cli-project，插件可能位于其 skills/filmcraft-cli-project 或宿主缓存目录；以实际加载路径为准，不按当前工作目录猜测，也不搜索后随意选择重复版本。技能目录与 CLI 的用户数据安装目录是两个独立位置。