用途
Orca CLI 用于通过公开的 orca 命令行工具操作 Orca 所管理的一系列资源，包括工作树（worktree）、文件夹上下文、终端、仓库、自动化、工作树评论，以及 Orca 应用内嵌的浏览器。
当 Orca 正在运行的编辑器或运行时是事实来源时，应使用该 CLI，例如：Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及 Orca 应用内嵌的浏览器。触发场景包括 "$orca-cli"、"Orca worktree"、"child worktree"、"spawn codex/claude in a worktree"、"read/wait/send Orca terminal"、"full handoff" / "handover" / "give this to another agent"，以及 "control the browser inside Orca"。当 Orca 状态无关紧要时，使用普通 shell 工具即可。
主要能力
该技能文件本身是一个发现入口（discovery stub），不是使用指南。完整且与版本匹配的 Orca CLI 参考文档由 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
该命令会打印出与即将处理后续命令的确切二进制相匹配的完整指南——涵盖工作树、交接、终端、自动化和内置浏览器。请先阅读它，再运行所需的具体命令。
不要凭记忆或该 stub 的缓存副本猜测子命令或标志。它们会随 Orca 版本变化，而该文件已刻意不再列出它们。用 ORCA status --json 确认应用已启动（如需要，用 ORCA open --json 启动），并优先使用 --json 进行智能体驱动的调用。
如果较旧的 Orca 不识别 skills get
仅当所选二进制明确报告 skills get 是未知命令时，才使用此回退方案。其他失败不能证明是较旧二进制；应报告它，而不是猜测或更换可执行文件。对于已确认的旧版二进制，仅使用以下有界的只读引导来定位。不要陷入死胡同，也不要臆造命令：
ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json
然后告知用户：更新 Orca 可通过 ORCA skills get orca-cli 恢复完整的、与版本匹配的指南。除这些命令外，请询问用户，而不是猜测这个较旧二进制可能不支持的命令面。
适用场景
适用于 Orca 正在运行的编辑器/运行时作为事实来源的场景，包括 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及 Orca 应用内嵌的浏览器。
限制
该技能文件是发现入口，不包含完整使用指南；完整参考由 orca 二进制提供。子命令和标志会随 Orca 版本变化，不应凭记忆或缓存猜测。在 Orca 管理终端之外的 Linux 上，裸 orca 通常解析为 GNOME Orca 屏幕阅读器，不应使用。若所选可执行文件无法运行，应报告确切错误并停止，不应回退到其他可执行文件。