vectorcraft-harness
Installation
SKILL.md
VectorCraft Harness(内置执行通道)
本技能是 VectorCraft 技能套件的唯一执行实现:首次安装、原生命令调用、workflow 编排、桌面桥接与交付核验都收敛在本目录 scripts/ 内。vectorcraft-use、vectorcraft-cli 及各领域技能是薄文档技能——它们提供场景指引、计划示例与参考契约,实际执行一律经由本技能的入口。执行任何 VectorCraft 脚本前,先把 HARNESS_DIR 设为本 SKILL.md 所在目录(宿主实际加载的绝对路径),不要假设当前工作目录就是技能目录。 用户级安装可能位于 ~/.agents/skills/vectorcraft-harness,项目级可能位于 .agents/skills/vectorcraft-harness,插件可能位于其 skills/vectorcraft-harness 或宿主缓存目录;以宿主实际加载路径为准。领域技能文档中的 SKILL_DIR 指领域技能自身目录(用于读取其 examples/、references/),与本 harness 是两个位置。
入口
| 入口 | 用途 |
|---|---|
scripts/bootstrap.py |
首次使用安装器:仅用标准库安装锁定的官方 CLI(runtime.lock.json 固定版本与摘要),返回 JSON executable。 |
scripts/cli.py |
公开 CLI 通道:按 argv 调用固定二进制;-- 后放原生子命令。 |
scripts/commands.py |
原生命令单技能入口:list / describe / run,参数说明、实时前置检查、同会话调用及失败回执。 |
scripts/workflow.py |
原生矢量操作助手:独立会话、限定读写目录和不可变修订交付;多画板导出与定向改色。 |
scripts/desktop.py |
桌面桥接:按固定官方 DMG 安装桌面应用并执行桌面计划;与 CLI 缓存分离。 |
其余 scripts/ 文件是上述入口的内部依赖(安全边界、会话与合同模块),不单独调用。
用法
场景指引、计划与示例文件取自对应领域技能目录(SKILL_DIR/examples/、SKILL_DIR/references/);执行路径一律使用本目录 HARNESS_DIR/scripts/。