用途：在设置、审查、调试或验证 Orca 按工作区环境配方时使用。这类环境是为每个工作区按需创建的一次性运行时，可以是云沙箱、虚拟机或本地环境。技能覆盖首次配置（提供商前置条件、可复用基础快照、编码代理认证快照、凭据与状态），而不只是每个工作区的生命周期脚本。可用于搭建按工作区环境、修复 orca.yaml 中的 environmentRecipes 条目、生成提供商生命周期脚本，或解决 orca vm recipe doctor 失败。
主要能力：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。若所选可执行文件无法运行，报告其确切错误并停止，不要回退到其他可执行文件。
运行 Orca 命令前先加载完整指南：ORCA skills get orca-per-workspace-env。它会打印与将处理后续命令的确切二进制版本匹配的完整指南，涵盖提供商设置、基础与认证快照、orca.yaml 中的 environmentRecipes、生命周期脚本和 orca vm recipe doctor。先阅读，再运行所需命令。不要凭记忆或缓存的旧副本猜测子命令或标志。用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），代理驱动调用优先使用 --json。
若旧版 Orca 不识别 skills get：仅当所选二进制明确报告 skills get 是未知命令时使用回退。其他失败不能证明是旧版二进制，应报告而非猜测或更换可执行文件。对于确认的旧版二进制，仅使用以下有界只读引导：ORCA status --json；ORCA vm recipe doctor <recipe-id> --repo-path <repo> --json。doctor 是免费的静态检查。未经用户明确批准，切勿添加 --provision，因为它会创建提供商资源并可能花钱。然后告知用户更新 Orca 可通过 ORCA skills get orca-per-workspace-env 恢复完整版本匹配指南。除此之外，应询问用户，而不是猜测旧版二进制可能不支持的命令面。
限制：本文件是发现存根，不是使用指南；完整参考由 orca 二进制提供，以避免与将运行命令的二进制产生偏差。