EffectCraft Harness 是 EffectCraft 技能套件的唯一执行实现,任务恢复账本、隔离 Python 准备、原生命令会话、评审与修订都收敛在其 scripts/ 目录内。effectcraft-use、effectcraft-cli 及各领域技能属于薄文档技能,只提供场景指引、计划示例与参考契约,实际执行一律经由本技能入口。执行前需先把 HARNESS_DIR 设为本 SKILL.md 所在目录的绝对路径,不要假设当前工作目录即技能目录;用户级、项目级、插件或宿主缓存路径均以宿主实际加载路径为准。
主要入口:scripts/launch.sh 为 POSIX 受管理入口(推荐),自动准备用户目录内的固定 Python 与 EffectCraft,不改全局 PATH,覆盖 plan/run/inspect/resume/review/revise/cancel 等动作;scripts/launch.ps1 为 Windows PowerShell 对应入口;scripts/cli.py 为隔离 Python 就绪时的直接 CLI 通道;scripts/commands.py 提供原生命令单技能入口(list_commands/execute_command 及参数目录与前置检查);scripts/workflow.py 为原生合成计划执行器,一般由 launch 脚本内部复用;scripts/bootstrap.py 为首次安装器,准备锁定的隔离 Python 3.13 并下载校验官方 EffectCraft 制品。
用法示例:HARNESS_DIR=/absolute/path/to/effectcraft-harness,然后 /bin/sh "$HARNESS_DIR/scripts/launch.sh" plan --mode workflow --plan PLAN.json --output /absolute/new-result,run 同理;Windows 用 & "$HARNESS_DIR/scripts/launch.ps1" run --mode workflow --plan PLAN.json --output "C:\Users\me\result"。原生命令计划追加 --mode commands,自有桌面会话用 --mode desktop。首次安装执行 python3 -I -B "$HARNESS_DIR/scripts/bootstrap.py",安装范围为用户数据目录,无需 sudo。原生命令直连与命令目录查询:python3 -I -B "$HARNESS_DIR/scripts/cli.py" -- info --json;python3 -I -B "$HARNESS_DIR/scripts/commands.py" list --filter <关键词>,后者输出恒为 JSON。
领域技能文档中的 SKILL_DIR 指领域技能自身目录,用于读取其 examples/、references/;脚本执行路径一律换成本目录 HARNESS_DIR/scripts/。执行合同(任务恢复账本、评审、修订、资源预算)见 effectcraft-use 技能的 references/managed-execution.md。