用途:通过 Orca 的 CLI 处理 Linear 工单,适合从已关联的 Linear 问题开始工作、用 PR/MR 链接与完成评论结束任务,以及推进工单状态。
主要用法:使用前先确定本次会话要用的可执行文件,并在后续所有命令中复用。若设置了 ORCA_CLI_COMMAND 环境变量,使用其值(Orca 会为受管 WSL 会话导出该变量);否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在非 Orca 受管终端之外的 Linux 上使用 orca-ide,切勿在那种环境下运行裸 orca(它通常解析为 GNOME Orca 屏幕阅读器 /usr/bin/orca 并开始朗读);其余情况使用 orca。下文中的 ORCA 是该可执行文件的占位符,运行前须替换,不要创建 shell 变量或直接照字面运行 ORCA。
运行 Orca 命令前,先加载与版本匹配的指南:ORCA skills get linear-tickets。优先使用 --json。指南未覆盖的命令或参数,可用所选可执行文件的 --help 查询。
限制与错误处理:若命令提示 Orca 未运行,可用 ORCA open --json 启动后重试;若以 runtime_access_denied 失败,说明沙箱阻止了连接,应使用提权权限重跑,且不要运行 ORCA open 或重启 Orca;若 skills get 未知,说明更新 Orca 可恢复该指南,此时可用 --help 做只读探索,不要猜测不支持的命令。若所选可执行文件无法运行,报告其确切错误并停止,不要改用其他可执行文件,以免悄然指向不同的 Orca 构建。