SuperAPI AI 工具集

artcraft-harness

智能体与模型

查看项目

更新于 10-16 00:28

技能介绍

用途:ArtCraft Harness 是 ArtCraft 技能套件的唯一执行实现。artcraft-use、artcraft-cli 及各领域技能属于薄文档技能,只提供场景指引、计划示例与参考契约,实际执行一律经由本 harness 的入口。

主要能力:提供八个入口。scripts/bootstrap.py 负责首次安装,--runtime-only 安装锁定 Node 与编排包,--plugin <domain> 增量安装所选领域技能源与原生 CLI;scripts/workflow.py 按任务图执行语义计划并自动安装所需领域;scripts/cli.py 提供公开编排 CLI 直连通道,含 --version、--help、run/status/cancel/package/verify-package;scripts/domain_commands.py 提供 list/describe/check/run 领域命令交接,可查询 2646 条命令;scripts/package.py 负责项目打包与移动验包;scripts/review.py 记录审阅;scripts/revision.py 执行受控修订;scripts/brief.py 管理版本化需求记录。

使用方式:执行任何脚本前先把 HARNESS_DIR 设为本 SKILL.md 所在目录的绝对路径,不要假设当前工作目录即技能目录。用户级安装可能在 ~/.agents/skills/artcraft-harness,项目级可能在 .agents/skills/artcraft-harness,插件可能在其 skills/artcraft-harness 或宿主缓存目录,以宿主实际加载路径为准。示例:python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py" --runtime-only;workflow.py 可接计划文件、--output、--authorization、--asset 等参数。cli.py 的原生子命令须放在 -- 之后,domain_commands.py 输出恒为 JSON。离线制品可用 --node-archive、--bundle-dir、--native-archive-dir 指定,但不绕过摘要、路径或版本验证;--runtime-home 或 CRAFT_RUNTIME_HOME 指定隔离安装目录。

适用场景:需要统一安装运行时、执行语义计划 workflow、调用公开 CLI、交接领域命令、打包验包、审阅与修订的 ArtCraft 任务。

限制:安装范围仅用户数据目录,不需要 sudo,不修改 PATH。scripts/setup.py 为内部实现,不作为独立入口;png_inspection.py、jpeg_inspection.py、consistency.py、mode_catalog.py、public_call.py、download.py、native_contract.py 由入口动态加载或子进程调用,不单独执行。运行时版本与制品摘要以 scripts/distribution.lock.json 与 scripts/node.lock.json 为准。执行合同见 artcraft-use 技能对应 references/ 文档,本技能 references/ 仅保存执行契约 JSON。