用途:该技能面向 Orca 的按工作区环境(Per-Workspace Environments),用于搭建、审查、调试或验证按需、一次性的运行时环境,可涉及云沙箱、虚拟机、SSH 主机或本地环境。本页是发现存根,会从当前会话所用的 Orca 可执行文件加载与版本匹配的指南。
主要能力与用法:先解析本次会话的 CLI,选定一个可执行文件并在后续命令中复用。若设置了 ORCA_CLI_COMMAND 环境变量,使用其值(Orca 会为受管 WSL 会话导出该变量);否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在 Orca 受管终端之外的 Linux 上使用 orca-ide,切勿直接运行裸 orca,因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并启动语音;其余情况使用 orca。文中 ORCA 是可执行文件的占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA,POSIX shell、PowerShell 和 cmd.exe 同理。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。运行 Orca 命令前先加载版本匹配的指南:ORCA skills get orca-per-workspace-env。优先使用 --json;指南未覆盖的命令或标志可用所选可执行文件的 --help。若命令报告 Orca 未运行,用 ORCA open --json 启动后重试;若失败并返回 runtime_access_denied,说明沙箱阻止了连接,应以提升权限重跑,且不要运行 ORCA open 或重启 Orca;若 skills get 未知,说明更新 Orca 可恢复指南,可用 --help 做只读发现,不要猜测不支持的命令。
限制:具体环境配方、平台支持与配置细节暂未提供。