orchestrating-cursor-cloud-agent

Cursor Cloud Agent オーケストレーション

あなた自身がオーケストレーターとしてCursor Cloud Agentにタスクを委託し、監視・レビュー・フォローアップを行います。コーディング作業はCursorに任せ、あなたは判断・監視・指示に特化します。

使用タイミング

以下の場合にこのスキルを発動してください：

• ユーザーが「Cursorに投げて」「Cursor Cloud Agentに任せて」「Cursorに委託して」と言及したとき
• ユーザーがCursor Cloud Agentを使ったタスク実行を依頼したとき

前提条件

• 環境変数 CURSOR_CLOUD_AGENT_API_KEY が設定されていること（Basic認証に使用）
• gh CLI がインストール・認証済みであること（Pull Request状態確認に使用）
• Linear MCP server (https://mcp.linear.app/mcp) が設定・認証済みであること
• cursor-agent-cli がインストール済みであること（go install github.com/syou6162/cursor-agent-cli@latest）

実行手順

1. タスク内容の確認

ユーザーと会話して、Cursor Cloud Agentに委託するタスク内容を固めます。

確認すべき項目：

• ターゲットリポジトリのURL
• 開始ブランチ（未指定の場合は main）
• タスクの概要・目的
• 関連するLinear issue（あれば）
• 特別な制約や注意点

2. エージェント作成

Cursor Cloud Agent APIでエージェントを作成します。

cursor-agent-cli create \
  -repo "https://github.com/<owner>/<repo>" \
  -branch "<開始ブランチ>" \
  -prompt "<タスク指示>"

プロンプトは -prompt フラグに加えて、標準入力（パイプ）からも渡せます。優先順位は -prompt フラグ > 標準入力 > エラーです。標準入力はパイプ経由の場合のみ有効で、TTY（対話端末）では読み取りません。

echo "<タスク指示>" | cursor-agent-cli create \
  -repo "https://github.com/<owner>/<repo>" \
  -branch "<開始ブランチ>"

長いプロンプトやシェルのクオート問題を避けたい場合は、ファイルに書いてパイプで渡すと安全です。

cat prompt.txt | cursor-agent-cli create \
  -repo "https://github.com/<owner>/<repo>" \
  -branch "<開始ブランチ>"

• cursor-agent-cli create は自動的に autoCreatePR: true を送信する。後から変更できないため、CLI の挙動に依存してよい。
• レスポンスの agent.url を必ずユーザーに提示すること。API経由で作成したエージェントはWeb UIの一覧に表示されないことがあるため、直リンクが必要。

プロンプトに必ず含めるCI確認指示:

Cursorへのタスクプロンプト（create / run）には、以下の指示を毎回末尾に含めること:

コード変更を push した後、必ず gh pr checks <PR番号> --repo <owner>/<repo> で CI の状態を確認してください。 失敗しているチェックがあれば、gh run view <run_id> --repo <owner>/<repo> --log-failed でログを確認し、原因を特定して修正してください。 すべてのチェックが pass するまで修正・push・確認を繰り返してください。

Cursor は自動では CI を確認しない（専用ツールや MCP を持たない）。gh CLI は認証済みで利用可能だが、プロンプトで明示的に指示しない限り自発的にはチェックしない。