用途:这是一个围绕 OpenCode CLI 的手动验证工作流技能,配合手动测试类技能使用,当运行证据依赖 OpenCode CLI 行为时提供可复现的命令与隔离策略。核心规则是按场景而非习惯选择隔离方式:OpenCode 仅作辅助代理时保留用户配置;测试 OpenCode 行为、插件、技能、提供商、权限或配置语义时则激进隔离;CI 中显式引导。opencode models 只证明可发现性,opencode run 才证明运行时兼容;技能或工具相关时须在 JSON 或日志中证明真实 tool_use,没有新命令输出不得声称兼容。
主要能力:提供场景矩阵与路由,例如辅助代理运行用 opencode run --dir <dir>;严格隔离运行使用临时 HOME、XDG 与 OPENCODE_CONFIG_DIR、OPENCODE_DISABLE_EXTERNAL_SKILLS、OPENCODE_CONFIG_CONTENT 等环境变量;还覆盖本地插件检查、提供商配置检查、技能加载测试、CI 与全新安装运行、工具调用检查,以及失败分类与证据报告要求。常用命令包括 type -a opencode、opencode --version、opencode debug paths/config/skill、opencode run --format json --print-logs --log-level DEBUG,并用 npm install --save-dev opencode-ai@<version> 与 npm exec -- opencode 固定版本。
使用方式:先判断本次运行是否应包含用户定制,再按场景路由选择命令;严格隔离时可定义 oc_isolated 包装函数,统一注入临时 HOME、XDG、配置目录与内联配置。技能加载测试需在 debug skill 与实际 tool_use 中同时验证。
限制:不编造未验证的事件名或功能;密钥不得打印,只报告已加载;临时家目录拷贝 auth 仅限明确要求时;若更换 HOME 后 opencode 异常,通常说明仍在使用包装器。缺失信息未提供。