Orca CLI 是一个用于操作 Orca 编辑器/运行时环境的命令行接口技能。它面向需要与 Orca 托管资源交互的智能体或开发者，帮助在 Orca 作为事实来源时执行相关操作。
用途 该技能用于操作 Orca 管理的各类资源，包括工作树（worktree）、文件夹上下文、终端、仓库、自动化、产物、工作树评论，以及 Orca 应用内嵌的浏览器。当 Orca 的运行编辑器/运行时是事实来源时，应启用该技能；当 Orca 状态无关紧要时，应改用普通 shell 工具。
主要能力 根据资料，该技能覆盖的操作范围包括：Orca 托管的工作树、文件夹上下文、终端、仓库、自动化、产物、工作树评论，以及 Orca 应用内嵌的浏览器。触发场景包括 "$orca-cli"、"Orca worktree"、"child worktree"、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接（handoff/handover）、将任务交给另一个智能体，以及控制 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 命令前，需加载完整指南：执行 ORCA skills get orca-cli，它会打印与即将处理后续命令的确切二进制版本匹配的完整指南，涵盖工作树、交接、终端、自动化和内置浏览器。应先阅读该指南，再运行所需的具体命令。不要凭记忆或缓存的存根副本猜测子命令或标志，因为它们会随 Orca 版本变化，且该文件已刻意不再列出它们。可用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），智能体驱动的调用优先使用 --json。
如果较旧的 Orca 不识别 skills get：仅当所选二进制明确报告 skills get 是未知命令时，才使用以下回退方案。其他失败不能证明是较旧二进制；应报告该失败，而不是猜测或更换可执行文件。对于确认的 pre-guide 二进制，仅使用以下有界、只读的引导命令来定位：
ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json
然后告知用户，更新 Orca 可通过 ORCA skills get orca-cli 恢复完整的、与版本匹配的指南。除这些命令外，应询问用户，而不是猜测该较旧二进制可能不支持的命令面。
适用场景 适用于 Orca 托管的工作树、文件夹上下文、终端、仓库、自动化、产物、工作树评论和内嵌浏览器等场景，以及需要在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、进行完整交接或将任务交给另一个智能体、控制 Orca 内嵌浏览器时。
限制 该文件是发现存根，不是使用指南；完整参考由 orca 二进制自身提供。不要凭记忆或缓存副本猜测子命令或标志。如果所选可执行文件无法运行，应报告确切错误并停止，不要回退到其他可执行文件。在 Orca 托管终端之外的 Linux 上，切勿运行裸 orca，因为它通常解析为 GNOME Orca 屏幕阅读器并启动语音。较旧二进制若不识别 skills get，仅可使用上述三条只读引导命令，其他情况应询问用户。