orca-cli について
orca-cliは、セッションに合ったOrca実行ファイルの選択と、使用前に対応するコマンドガイドを確認する手順を示すスキルです。コマンドの安全な確認方法と、セッション固有の実行エラーへの対処も説明します。
主な機能
- 01セッションに対応するOrca実行ファイルの特定
- 02対応するCLIガイドの読み込み
- 03JSON形式のコマンド出力を優先
- 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 は選択した実行ファイルを表すプレースホルダーです。何かを実行する前に置き換えてください。シェル変数を作成したり、文字どおり ORCA を実行したりしないでください。POSIX シェル、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 を使用し、サポートされていないコマンドを推測しないでください。