关于 orca-cli
orca-cli 是一项技能,指导 Agent 选择当前会话对应的 Orca 可执行文件,并在使用前读取匹配版本的命令指南。它还说明如何安全地发现命令及处理会话特定的执行错误。
主要功能
- 01解析当前会话的 Orca 可执行文件
- 02读取匹配版本的命令指南
- 03优先使用 JSON 命令输出
- 04用帮助信息查询未说明的命令
- 05安全处理运行时访问错误
适用场景
- 01准备在会话中运行 Orca 命令
- 02无需猜测即可发现可用命令
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ praxstack/ stablyai-orca --skill orca-cli安装后在 Claude Code 中输入/orca-cli确认已加载。
详细介绍
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
优先使用 --json。对于指南未涵盖的命令或标志,请使用所选可执行文件的 --help。如果命令报告 Orca 未运行,请使用 ORCA open --json 启动它,然后重试。如果命令因 runtime_access_denied 失败,说明沙箱阻止了连接:请提升权限后重新运行,不要运行 ORCA open 或重启 Orca。如果找不到 skills get,请说明更新 Orca 可恢复指南;使用 --help 进行只读探索,不要猜测不受支持的命令。
评论
支持 Markdown