用途:本技能负责创建和编辑蒙版路径、羽化及局部遮罩,与同包其他技能按名称交接,可单独安装使用。
主要能力:通过固定官方 effectcraft-cli 完成蒙版路径、羽化范围与局部遮罩的创作,保留原生编辑工程并产出派生输出;支持命令查询与参数核对(commands --filter 与 describe),属性读写用 props/get/set,执行用 exec 或 run;可用 --save-as 保留新工程。安装成功、命令目录存在与创作任务完成需分别报告。
使用方式:将 SKILL_DIR 设为宿主实际加载的本 SKILL.md 所在目录;将 HARNESS_DIR 设为 effectcraft-harness 技能实际加载目录。创作写入默认使用受管理启动器:在类 Unix 环境运行 /bin/sh "$HARNESS_DIR/scripts/launch.sh" plan --mode workflow --plan PLAN.json --output /absolute/new-result 与 run 版本;Windows 使用 launch.ps1 并替换路径。原生命令需先准备解释器,示例:python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --version、commands --json;argv 在 -- 之后且原生子命令须放首位。单独安装依赖用 npx skills add full-aigc-skills/effectcraft-skills --skill effectcraft-harness,其他技能用 --skill <skill-name>。
适用场景:蒙版与遮罩创作、路径动画相关工作流、局部返工、原生工程修订与 GUI 任务(先经固定桌面安装)。
限制:不提供虚构登录接口,本地 headless 不要求云账户;原生制品支持 macOS arm64/x86_64、Windows x86/x64/arm64、Linux x86_64/aarch64,无需预装 Python。锁定制品摘要失败、损坏安装或不支持平台时应停止,不改 PATH、不执行浮动升级。命令非零退出不算完成,需实际查看保存工程与媒体;超时结果标 unknown,不能自动重放编辑。闭合路径、合成坐标与羽化范围需验证,不得称未测试的自动 roto 为可靠主体识别。本技能不通过相邻文件路径加载其他技能。