gemini について
補助スクリプトを介して、Cursor のヘッドレスコマンドラインに単発タスクを渡すスキルです。現在のワークスペースや指定したプロジェクトでの実行、計画、Q&Aに利用できます。
主な機能
- 01Cursor による単発のヘッドレス実行
- 02補助スクリプト経由のプロンプト送信
- 03plan または ask モードの選択
- 04プロジェクトディレクトリやモデルの指定
- 05Cursor の出力とエラーの返却
活用シーン
- 01スキル呼び出しからタスクを委任
- 02読み取り専用の計画や説明を依頼
- 03別のプロジェクトで Cursor を実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ petekp/ claude-code-setup --skill geminiインストール後、Claude Code で/geminiを入力して読み込まれたか確認します。
同梱ファイルscripts/run-cursor.sh
詳細
Gemini
cursor agent --printを使用するCursorヘッドレスCLIで、単発の自律実行を行います。
ワークフロー
- 先頭の
/geminiトークンを削除し、その後のすべての内容をそのまま保持します。 - 残りのプロンプトが空の場合は、Cursorに何をさせるかユーザーに尋ねます。
- このスキルディレクトリを基準に
scripts/run-cursor.shの場所を解決し、プロンプトを標準入力経由で渡します。 - Cursorの出力をユーザーに共有します。
- Cursorがファイルを変更した場合、または具体的な提案を行った場合は、重要な結果を平易な言葉で要約します。
呼び出し
現在の作業ディレクトリからのデフォルトの呼び出し:
PROMPT="<everything after /gemini>"
printf '%s' "$PROMPT" | "<skill-dir>/scripts/run-cursor.sh"
便利なオプション:
--cd /path/to/project:別の作業ディレクトリを対象にCursorを実行します--mode plan:読み取り専用の計画・分析を行います(ファイル編集なし)--mode ask:質疑応答形式の説明を行います(読み取り専用)--model <model>:デフォルトのモデルを上書きします(例:gpt-5、sonnet-4、sonnet-4-thinking)
動作
ヘルパースクリプトは次の処理を行います。
cursorがPATH上で利用可能か確認します- クリーンなヘッドレス実行のために
--print --force --trust --output-format textを使用します --workspaceを使用して作業ディレクトリを設定します- 標準出力と標準エラー出力を一時ディレクトリに分けて保存します
- 成功時はCursorのテキスト出力のみを返します
- Cursorがゼロ以外の終了コードを返した場合、または出力がない場合は、明確に失敗を通知します
注意事項
- バックグラウンド実行に対応したシェルツールを実際に使用している場合を除き、これをバックグラウンド実行として説明しないでください。
- Cursorが失敗した場合は、再試行して黙って済ませず、関連するエラー出力を表示してください。
cursorが見つからない場合は、Cursor CLIがインストールされていないか、PATH上にないことをユーザーに伝えてください。- 認証には
CURSOR_API_KEY環境変数、または事前のcursor agent loginを使用します。
コメント
Markdown 対応