cursor-agent

Cursor エージェント

Cursor のヘッドレス CLI エージェント（cursor-agent）にタスクを委任します。これを使って、コードレビュー、計画の批評、テキスト・コピーのレビュー、または一般的な Q&A について、Claude 以外のモデルからセカンドオピニオンを得られます。

入力

• $task: cursor-agent に渡すタスク。通常はレビューまたは質問のプロンプトです。ユーザーがモデルのヒント（例: 「Opus で」「GPT を使って」「pomocí Sonnetu」）を追加した場合は、それを抽出して --model で渡します。

目標

cursor-agent をヘッドレスで実行し、その出力をユーザーに提示し、さらに簡潔な Claude の TL;DR を添えて、ユーザーが長文を読み返さずに済むようにします。

手順

1. タスクを解析する

$task と周囲の会話から次を抽出します:

• モデルのヒント — 次のような表現を探します:
  • 「Opus」/「claude」→ --model claude-opus-4-7-medium
  • 「Sonnet」→ --model claude-4.6-sonnet-medium
  • 「GPT」/「GPT-5」/「Codex」→ --model gpt-5.3-codex
  • 「Gemini」→ --model gemini-3.1-pro
  • 「Auto」→ --model auto
  • 何も言及がない場合 → --model を省略（cursor はデフォルトの composer-2-fast を使用）
• モードのヒント:
  • 「plan」/「plan mode」/「navrhni」→ --mode plan
  • 「write」/「edit」/「implement」/「headless」→ --mode を省略（cursor は書き込み可能）
  • それ以外 → --mode ask（読み取り専用、デフォルト）
• これはレビューか? タスクに「review」「check」「verify」「second opinion」が含まれる場合、またはブランチ/PR/差分を参照している場合は、プロンプトを強化します（手順 2）。

成功基準: フラグが決定され、プロンプトの準備が整っている。

2. プロンプトを強化する（レビューのみ）

タスクがコードレビューの場合:

• 差分の範囲を特定します。次の順に試します: タスク内の明示的な参照（PR 番号、ブランチ名）、現在のブランチと main の比較（git diff origin/main...HEAD）、または未コミットの変更（git diff HEAD）。
• cursor-agent が何を確認すべきか分かるように、プロンプトの先頭に短い指示を追加します:

  「ブランチ <name> を main と比較してレビューしてください。git diff origin/main...HEAD を使って実際の変更を確認してください。実際の問題（正確性、エッジケース、セキュリティ）に焦点を当て、細かい指摘は省いてください。file:line 参照付きで約 400 語以内で報告してください。」

レビュー以外のタスク（ask/plan/テキスト/UI）では、タスクをそのまま渡します。

成功基準: CLI 用の最終的なプロンプト文字列が準備できている。

3. cursor-agent を実行する

Bash 経由でヘッドレスに呼び出します:

cursor-agent -p --output-format text [--mode <mode>] [--model <model>] "<prompt>"

• 常に -p（print/headless）を使用します。
• タスクが構造化出力を必要としない限り、常に --output-format text を使用します。
• ワークスペースはデフォルトで pwd です — ユーザーが明示的に別のディレクトリを指定しない限り --workspace を渡さないでください。
• 書き込みを伴わないモード（--mode ask または --mode plan）のみの実行では、追加の権限フラグは必要ありません。ヘッドレスの書き込みモードでは、--force や --yolo を黙って追加せず、まずユーザーに尋ねてください。
• 応答が非常に長くなりそうでコンテキスト使用量を抑えたい場合は tail -n 200 にパイプします。デフォルトでは完全な出力を取得します。

成功基準: cursor-agent が応答を返す（終了コード 0）。エラー（認証、モデルが利用不可など）が発生した場合は、それを隠さずユーザーに提示します。

4. 出力を返す

次の順序でユーザーに提示します:

1. cursor の応答そのまま — ユーザーがもう一方のモデルの声を直接聞けるように、file:line 参照を含めてそのまま引用します。
2. あなたの短い TL;DR — 最大 3〜6 個の箇条書きで、水平線で区切ります。何が本質的で何がノイズかを強調し、具体的な次のアクションを提案します。cursor の指摘を黙ってフィルタリングしないでください。意見が異なる場合は、明示的に指摘します。

要約は簡潔に保ってください — 目標はユーザーが読み返す手間を省くことであり、cursor の出力を置き換えることではありません。

成功基準: ユーザーが cursor の生の出力と Claude が整理したアクションリストの両方を確認できる。

注意事項

• cursor-agent --list-models は利用可能なすべてのモデル ID を表示します。ユーザーが特殊なもの（例:「thinking tier」「max tier」）を求めた場合は、まずこのリストを確認してください。
• cursor-agent は他のコマンドラインツールと同様に、現在のワークスペース内で読み書きを行います — デフォルトではサンドボックス化されていません。その出力は、チームメイトの PR コメントを扱うときと同じように扱ってください。信頼しつつも検証を。
• このスキルはワンショットの委任を目的としています。より長いやり取りが必要な場合は、ユーザー自身が cursor-agent を対話的に実行できます（-p なし）。