用途:本技能负责 ArtCraft 的局部返工,即替换 Logo 或指定资产、修改原生子工程并更新下游产物。与同包技能按名称交接,单独安装即可使用,不读取兄弟目录。上游 ArtCraft 是 Tauri 应用,本技能使用项目本地编排 CLI,不安装或冒充同名官方 CLI。
主要能力:执行实现收敛在内置的 artcraft-harness 技能(随插件捆绑安装;单独安装用 npx skills add full-aigc-skills/artcraft-skills --skill artcraft-harness)。将 HARNESS_DIR 设为该技能实际加载目录(绝对路径);本技能的 SKILL_DIR 只用于读取自身 examples/ 与 references/,脚本执行路径一律使用 $HARNESS_DIR/scripts/。输入为用户已确认的任务、素材、工程或对象、输出目录与修改范围;返回实际 CLI 结果、保存后的原生工程、派生输出与核验记录。
使用方式:当前支持 macOS arm64、Python 3.11+。基础入口安装固定 Node 与编排包;workflow.py 按任务图安装所需领域技能源和原生 CLI,不要求全局 Node。将 SKILL_DIR 设为宿主实际加载的本 SKILL.md 所在目录(绝对路径),用户级可能在 ~/.agents/skills/artcraft-cli-revise,项目级可能在 .agents/skills/artcraft-cli-revise,插件可能在其 skills/ 或宿主缓存目录,以实际加载路径为准。示例命令: : "${SKILL_DIR:?请先设置为本 SKILL.md 的实际所在目录}" python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py" --runtime-only python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --version python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --help CLI argv 在 -- 后,原生子命令必须放首位;安装参数放分隔符前;--runtime-home 可隔离缓存。本项目 --help 定义 run/status/cancel/package/verify-package;语义计划走 workflow.py。审阅驱动连续修订使用 revision.py step/status。
适用场景:品牌色板混合返工、动态透明序列交接、原生渐变与多重填充改色、父级与透明度表达式返工、Photo 调整层与选区蒙版、混合 ASR 与字幕、跨产物一致性审阅等,均有对应指南与示例。
限制:锁定制品摘要失败、损坏安装或不支持平台时停止;不改 PATH、不执行浮动升级。命令非零退出不算完成;超时结果标 unknown,不能自动重放编辑。本技能不提供虚构登录接口,本地 headless 不要求云账户。完整 GUI、跨编辑器保真与创作质量按实际证据陈述。遇到 runtime_upgrade_busy 时保留旧运行时、原工程和账本,不删除租约或强行修改状态。安装失败与原生调用失败分别处理。