grok-build-cli について
grok-build-cli は、Codex からローカルの `grok` コマンドラインを呼び出すスキルです。利用可否の確認や呼び出し形式の選択、出力処理、安全上の制限を扱います。
主な機能
- 01CLI とモデルの利用確認
- 02単一ターンとエージェント型の選択
- 03UTF-8 ファイルからのプロンプト指定
- 04セッションのポーリングと出力取得
- 05必要に応じた実行環境の分離
- 06実行時の安全制限
活用シーン
- 01Grok から直接回答を得る
- 02Grok でウェブや X を検索する
- 03独立したセカンドオピニオンを得る
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pluviobyte/ rnskill --skill grok-build-cliインストール後、Claude Code で/grok-build-cliを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
Grok Build を呼び出す
Codex からローカルの grok CLI を呼び出します。無関係な調査、ダウンロード、編集、または本番環境向けのワークフローは追加しないでください。
利用可能か確認する
タスクで最初に呼び出す前に、次を実行します。
command -v grok
grok models
grok models により、ユーザーがログイン済みであることを確認し、利用可能なモデルが少なくとも 1 つ表示される必要があります。認証がない場合はその旨を伝え、ユーザーが対話形式での認証を希望する場合に限り grok login を実行します。
呼び出し形式を選ぶ
Grok のツールを必要としない、1 回の応答で完了する直接的な回答には、次を使用します。
grok --single 'PROMPT' --output-format plain
X やウェブ検索など、Grok のツールを利用する可能性があるエージェント型タスクでは、プロンプト全体を UTF-8 ファイルに保存して、次を実行します。
grok --prompt-file '/absolute/path/prompt.md' \
--max-turns 8 \
--output-format plain
ユーザーが特定の利用可能なモデルを指定した場合に限り、--model MODEL を使用します。それ以外の場合は、Grok に設定されているデフォルトを使用します。
Codex から実行する
- 長いプロンプトには
apply_patchでprompt.mdを作成し、壊れやすいシェルのクォートは避けます。 exec_commandで Grok を起動します。通常はyield_time_ms: 1000を使用します。- コマンドがセッション ID を返した場合は、空の文字列を送信し、1 回のポーリングにつき最大 30 秒待って
write_stdinでポーリングします。 - 呼び出しに 60 秒を超える場合は、簡潔な進捗状況を伝えます。
- Grok の最終的な標準出力を取得します。終了コードが 0 以外の場合、
Max turns reachedが出力された場合、または最終出力が空の場合は、失敗として扱います。 - 必要に応じて Grok の回答であることを明示し、Grok の回答をユーザーに返します。
分離
Grok に提示されたプロンプトだけを実行させ、現在のリポジトリにあるスキルや指示を調べさせない場合は、空の一時作業ディレクトリを渡します。
GROK_CALL_DIR="$(mktemp -d)"
grok --cwd "$GROK_CALL_DIR" --no-memory --no-subagents \
--prompt-file '/absolute/path/prompt.md' \
--max-turns 8 \
--output-format plain
ウェブや X の調査、および独立したセカンドオピニオンでは、デフォルトでこの分離を使用します。Grok にプロジェクトを読み取らせたり変更させたりする必要がある場合に限り、実際のプロジェクトディレクトリを使用します。
ガードレール
- CLI が実際に実行されていない場合、Grok を呼び出したと主張しないでください。
- Grok の応答が空または失敗した場合に、その内容を捏造したり、成功したかのように言い換えたり、黙って置き換えたりしないでください。
- プロンプトやコマンドライン引数に秘密情報を渡さないでください。
- ユーザーが該当する変更を明示的に許可していない限り、
--always-approve、bypassPermissions、または広範な書き込み権限を使用しないでください。 - 無関係な過去の Grok セッションを再開しないでください。ユーザーが特定の Grok セッションの続行を明示的に求めた場合を除き、新しい呼び出しを開始します。
- このスキルはタスクに依存しないものとし、Grok に何をさせるかはユーザーのプロンプトで決めます。