用途:本技能面向 EffectCraft 的木偶与局部变形动画,为素材、文字与图形建立木偶网格及针脚,制作局部变形、录制运动与跟随动画。调用固定官方 effectcraft-cli,保留原生编辑工程。
主要能力:查询实际命令参数与能力,调用公开 CLI、MCP 与诊断;读取当前工程状态与命令 enabled/params 后构造 argv;属性读写用 props/get/set,命令用 exec <id> --params <JSON> 或成对的 run <id> <JSON>;用 --save-as 保留新工程。支持原生组合与源工程修订,通过 effectcraft-harness 技能的 scripts/workflow.py 执行。
使用方式:先设置 SKILL_DIR 为宿主实际加载的本 SKILL.md 所在目录(绝对路径),将 HARNESS_DIR 设为 effectcraft-harness 技能实际加载目录。创作写入默认使用 launch.sh / launch.ps1,自动准备用户目录内的固定 Python 与 EffectCraft,不改全局 PATH。示例:/bin/sh "$HARNESS_DIR/scripts/launch.sh" plan --mode workflow --plan PLAN.json --output /absolute/new-result;Windows 用 & "$HARNESS_DIR/scripts/launch.ps1" run --mode workflow --plan PLAN.json --output "C:\Users\me\result"。CLI argv 在 -- 后,原生子命令必须放首位。
适用场景:木偶网格与针脚、局部变形、运动录制与跟随动画;父子图层、属性表达式、动态预览与源工程返工;GUI 任务可先用自带固定桌面安装。
限制:命令非零退出不算完成,需查看真实保存工程、导出、尺寸及媒体解码;超时结果标 unknown,不能自动重放编辑。锁定制品摘要失败、损坏安装或不支持平台时停止;不改 PATH、不执行浮动升级。本技能不提供虚构登录接口,本地 headless 不要求云账户。完整 GUI、跨编辑器保真与创作质量按实际证据陈述。安装/诊断交给 effectcraft-cli-setup,完整任务路由交给 effectcraft-use。