用途:本技能负责查询 ArtCraft 实际命令参数与能力,调用公开 CLI、MCP 与诊断,并提供首次安装与公开 CLI 入口。上游 ArtCraft 是 Tauri 应用,本技能使用项目本地编排 CLI,不安装或冒充同名官方 CLI。
主要能力:查询当前版本与命令目录;读取工程状态与命令 enabled/params 后构造 argv;执行只读与编辑调用;核验保存后的原生工程、导出、尺寸与媒体解码;按 references/recovery.md 与 references/project-package.md 处理恢复与打包。本项目 --help 定义 run/status/cancel/package/verify-package;语义计划走 workflow.py。
使用方式:将 SKILL_DIR 设为宿主实际加载的本 SKILL.md 所在目录(绝对路径),将 HARNESS_DIR 设为 artcraft-harness 技能实际加载目录,脚本执行路径一律使用 $HARNESS_DIR/scripts/。基础入口安装固定 Node 与编排包,workflow.py 按任务图安装所需领域技能源和原生 CLI。CLI argv 在 -- 后,原生子命令必须放首位;安装参数放分隔符前,--runtime-home 可隔离缓存。单独安装可用 npx skills add full-aigc-skills/artcraft-skills --skill artcraft-harness。
适用场景:需要查询命令参数、调用公开 CLI、执行诊断、创建对象、组合操作、源工程修订与交付核验时使用。安装/诊断交给 artcraft-cli-setup,完整任务路由交给 artcraft-use。
限制:当前支持 macOS arm64、Python 3.11+。命令非零退出不算完成;超时结果标 unknown,不自动重放编辑;锁定制品摘要失败、损坏安装或不支持平台时停止,不改 PATH、不执行浮动升级。本地 headless 不要求云账户,不提供虚构登录接口。Vector desktop/bridge 重复命令尚未完成执行资格,不能按 headless 目录回退。