用途:本技能负责 VectorCraft CLI 的首次安装、摘要校验、版本检查与缺失运行时排障,与同包其他技能按名称交接,单独安装即可使用,不读取兄弟目录。
主要能力:定位当前 SKILL.md 的真实目录(用户级可能位于 ~/.agents/skills/vectorcraft-cli-setup,项目级可能位于 .agents/skills/vectorcraft-cli-setup,以实际加载路径为准);执行内置 vectorcraft-harness 的 bootstrap.py 完成安装;通过 cli.py 检查版本与命令目录;核对 JSON 回执中的可执行路径、摘要与版本,不依赖 shell PATH。
必要用法:将 SKILL_DIR 设为实际加载目录,HARNESS_DIR 设为 vectorcraft-harness 技能实际加载目录。命令示例:python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py";python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- --version;python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- commands。CLI argv 在 -- 后,原生子命令放首位;安装参数放分隔符前,--runtime-home 可隔离缓存。单独安装 harness 用 npx skills add full-aigc-skills/vectorcraft-skills --skill vectorcraft-harness。
适用场景:首次安装、版本与摘要核验、缺失运行时诊断、命令目录查询与原生工程创建/返工前的环境准备。
限制:当前支持 macOS arm64、Python 3.11+;固定 CLI 安装到用户数据目录。锁定制品摘要失败、损坏安装或不支持平台时停止;不修改 PATH、不使用 sudo、不执行浮动升级。命令非零退出不算完成,超时结果标 unknown,不能自动重放编辑。本技能不提供登录接口,本地 headless 不要求云账户。当前运行时为基于官方 v0.2.0 的维护版 0.2.0-craft.2。其他平台与完整 GUI 支持情况暂未提供。