第2章 · レッスン 06 / 17

やる一周を完結する

変更を確認し、反映を決める

差分と Pull Request は、ていねいに見れば大丈夫です

  • 目安 16 分
  • 進捗 6/17

このレッスンのゴール

  • Pull Request を『変更の提案書』として説明できる
  • 差分で見るべきポイントを挙げられる
  • マージと差し戻しの判断基準を持つ
  • 開いた PR を見守る近道が `/autopilot` だと知る
  • Fix with Agent のあと下書きが残ることと、コミットをやめても PR は開かないことを知る
  • 中身が見えない差分は変更ゼロではなく、Apply が止まる印だと知る
  • Origin の Changes タブで、行の差分の前に Tour(案内)を読めると知る
  • 自分が開いていない PR の説明は下に足され、作者の文は消えないと知る
  • cursor.com の PR ページでは Agent 一覧が入力欄のすぐ上にあり、Waiting on は下の Agent 待ちだと知る
  • Cloud Agent が開く PR は、頼んでいなければ最初から Ready で、Ready は反映済みではないと知る
  • 非公開の Origin の提案書では、コメント末尾の Open in Web が、その Agent の実行を開くと知る
  • cursor.com の提案書で Fix with agent を押すと、出した Agent か、その提案書で直前まで動かしていた Agent への追記で、時刻が新しいほうとは限らないと知る
マージがグレーのときマージボタンがグレーのときChecks が緑でも、承認・保護ルール・権限で止まることがあります。まず6つの原因を順に疑います。積み重なった子の auto-merge はいちばん下まで待ち、親を先に反映した子の積み直しは、この6つとは別です。
マージボタンがグレーのときの6原因図。Checks が赤、behind、コンフリクト、必須レビュー未承認、ブランチ保護、マージ権限不足。Origin 上の保管庫では⑤は Rules and Protections。積み重なった子の auto-merge はいちばん下まで待つ。
図の内容をテキストで読む

コード側 · ①〜③

  1. ①Checks が赤 → pull-request-deep の CI 3択(再実行 / 調査だけ / 修正依頼)
  2. ②behind → Update branch(スマホでも可)
  3. ③コンフリクト → Agent に『main の最新を取り込んで解消して』と依頼

チーム側 · ④〜⑥

  1. ④必須レビュー未承認 → レビュアーを足す(Request reviewers)
  2. ⑤ブランチ保護・必須チェック。Origin 上の保管庫なら Settings の Rules and Protections
  3. ⑥マージ権限なし・カスタムロール → 管理者に権限を確認

Checks が緑でもマージできないときは④⑤⑥を疑います。Origin 上の保管庫では⑤は Settings の Rules and Protections。auto-merge をオンにしても、条件が揃うまで反映は始まりません。積み重なった子は、いちばん下の開いている PR になるまで待ちます。

SVG をダウンロード

操作イメージ5 ステップ
Pull Request の確認イメージ。要約 → Files changed → チェックリスト → マージの流れ
  1. Conversation で Agent の要約を読む
  2. Files changed で意図しない変更がないか見る
  3. マージがグレーなら上の6原因図どおり。Checks が赤だけなら pull-request-deep の CI 3択図へ
  4. マージまで任せたいなら `/autopilot`、またはこのレッスンのマージまで任せるレシピ節を確認
  5. 問題なければ Merge(反映)
コードが読めなくても、要約・差分・チェックリストで判断できます。
第2章のレッスン一覧6 / 17
  1. 05開発は「依頼→変更→確認→反映」のループ8分
  2. 06変更を確認し、反映を決める16分
  3. 07指示したあと、何が起きる?12分
  4. 08追加指示とやり直し10分

Pull Request は提案書

Pull Request(よく PR と略します)は、「この変更を本番の流れに入れてよいですか?」という提案です。Agent が作業を終えると、この提案の形で返ってくることが多くあります。

まだマージしていなければ、main ブランチ(本番に近い本線)は変わっていません。安心して中身を読めます。

Origin 上で作った保管庫の PR は cursor.com/codebase の Pull Requests タブです。公式の画面は Activity(会話と状態)/ Commits / Checks / Changes の4つです。4つ目の Changes は、GitHub の Files changed に相当します。名前が Files Changed の5つ目のタブがあるわけではありません。Changes の中で Diff(行の差分)と Tour(案内)を切り替えます。読み方はこのレッスンの末尾です。枝を Origin に送ったあと、保管庫の Code タブからも PR を開けます。GitHub から同期した保管庫なら、Cursor 上に出るのは GitHub の PR です。同期した PR にも案内は出ますが、機能は少なめです。同期保管庫の origin/ で始まる枝は Origin 側だけに残り、GitHub の PR の先頭にはなりません(公式 Origin pull requests / Code Tours)。

Origin CLI で作る PR は既定が Draft です。確認できたら Ready にしてください。画面からも、Agent に『Ready にして』と頼んでもできます(公式 Origin CLI PR)。

Cloud Agent や Project のワーカーが開く PR は別です。頼んでいなければ最初から Ready です。見分けは「Cloud Agent が開く PR は、最初から Ready」です。

Checks タブは先頭コミット向けです。push したのに古い結果のままなら、Agent に『PR を refresh して』と頼むか origin pr refresh です。通常は push で新しい版が作られるので、画面が追いついていないときだけ使います(公式 Origin CLI PR)。

はじめての方が見るチェックリスト

コードが読めなくても、次の点は確認できます。

  • 意図した画面・文言だけが変わっているか
  • 関係ないファイルまで大量に触っていないか
  • 秘密情報(鍵、パスワード、個人情報)が入っていないか
  • Agent の説明と、実際の差分の内容が一致しているか
  • 『なぜこの変更が入ったか』が分からなければ `/cursor-blame`(AI の変更と依頼文を調べる。公式 Agent Skills)
  • マージや push の前に先に読んでもらいたいなら `/review`(合うレビュー Agent を選ぶ。明示するなら `/review-bugbot` / `/review-security`。同じ差分のまま PR を出すと保管庫側は再実行を飛ばすことがある。Cursor 3.7+ / cursor.com/agents / CLI)
  • PR の説明文に要約が増えていたら、Bugbot の PR Summary(既定は説明文へ追記)かどうかを先に見る。作者の意図文と混ぜて読まない。頼んだ Agent の追記は、既存の文の下に足すだけで置き換えない(このレッスン末尾。automations の Bugbot の要約と直し方)
  • Desktop で手元の変更だけ先に読むなら `/agent-review`(Agent Review。PR の Bugbot とは別。設定は Agents、Cursor 3.11 以降は Git & PRs。when-desktop)
  • 成果物(スクショ・動画・ログ)やプレビューがあれば、見た目と手順で確認する
  • Origin の Changes なら、行の差分の前に Tour(案内)を読む。T で Diff と行き来する(このレッスン末尾)
  • cursor.com の PR ページで Agent を見るなら、入力欄のすぐ上。Waiting on は下の Agent 待ち。読み込みが終わらないときは Retry。Legacy と出たらプライバシー(このレッスン末尾)
  • Cloud Agent が開いた PR が最初から Ready でも故障ではない。下書きにしたいは依頼文か、Never open PRs as drafts(「Cloud Agent が開く PR は、最初から Ready」)
  • 非公開の Origin の提案書では、Cloud Agent のコメント、返信、レビューの末尾の Open in Web が、その Agent の実行を開く(このレッスン末尾)
  • cursor.com の提案書で Fix with agent を押したら、出した Agent か、その提案書で直前まで動かしていた Agent への追記。時刻が新しいほうとは限らない(このレッスン末尾)
  • 本線より遅れている(behind)表示が出ていないか → 出ていたら Update branch で取り込んでから判断(pull-request-deep の behind 節)
  • コンフリクト(競合)と表示されていないか → 出ていたら Agent に『main の最新を取り込んでコンフリクトを解消して』と依頼(自分で直すより安全なことが多い)
  • 成果物が無い/『確認できなかった』と書かれている → 仕事場(環境)不足のサインかもしれない(第4章)

コピペ用:PR 確認メモ

確認のたびにゼロから考えなくて大丈夫です。次の型をメモや PR コメントに貼り、カッコ内だけ埋めてみてください。

  • 意図どおり: (はい / いいえ)。ずれている点: ()
  • 触ってほしくない範囲は無事か: (はい / 要確認)
  • 秘密情報・個人情報が写っていないか: (はい / 怪しい)
  • 成果物 or プレビューで見たこと: ()
  • behind / コンフリクト: (なし / Update branch 済 / Agent に解消依頼)
  • 次の一手: (マージ / 追加指示 / 人に相談)

成果物とリモートデスクトップ

Cloud Agent は、マージしやすい PR に加えて、デモ用の成果物(artifacts)としてスクリーンショット、動画、ログを残せます。公式では成果物は PR に紐づけられ、手元にブランチを落とさなくても検証しやすくなります。文言や見た目の確認なら、差分より先に成果物を見る方が早いことが多いです。

Agents Window の会話や全画面に動画が出たときは、ミュート/解除のボタンがあります。次の動画は、直前に選んだ状態から始まります(公式 changelog 3.24 / Agents Window)。突然音が出るのが嫌なら、最初の本でミュートしておきます。

成果物がアップロードされると、ダッシュボードの実行イベントに `artifact_created` と出ます(environments-and-secrets の実行イベント節)。イベントが無いのに『確認した』と書かれているときは、環境不足やネットワーク制限を疑いましょう。

GitHub の PR 説明文に画像を自動で埋め込みたいときは、別設定の Allow posting artifacts to GitHub が必要です(このレッスン後半の成果物を PR 本文に載せる設定節)。Agent 画面や PR に紐づく成果物は見えているのに、GitHub 本文だけ空、というときはここを疑います。

Agent が動いているクラウド上のデスクトップを一時的に操作して、自分で画面を触って試す機能(remote desktop control)もあります。手元にブランチを落とさなくても、『動いたか』を体感で確かめられます。試し終わったら操作を返し、Agent に続きを任せます。

反映のしかた

問題なければ Merge(反映)します。チームによっては Approve(承認)が先に必要なこともあります。だめなら Close したり、追加コメントで Agent に修正させたりします。

スマホの Cursor アプリからも、差分確認やマージ操作が行えます。通勤中に確認し、大きな判断だけデスクで行う、といった使い方が現実的です。

auto-merge と Subscriptions の使い分け

PR を出したあと、毎回『CI が緑になったら続けて』と書く代わりに、道具を組み合わせられます。混同しやすいので、役割だけ先に固定しましょう。

  • `/autopilot`(最初から入っている Skill): 開いた PR の指摘・コンフリクト・赤い Checks・残り仕事を見守って直す。マージまで任せたいときの最短入口(公式 Agent Skills)
  • auto-merge(GitHub / スマホ): あなたがオンにすると、Checks・承認・behind なし・コンフリクトなしなどの条件が揃ったタイミングで自動反映される。Agent は動かない。Origin 上の PR では同じ役割が『条件が揃ったらマージ』(origin pr merge --auto / Agent に『条件が揃ったらマージして』)。積み重なった子は、いちばん下の開いている PR になるまで待つ(末尾の節)
  • Subscriptions(Agent): レビューコメント・CI 結果・Slack 返信などを待って、同じ会話で Agent が自動再開し、直し続けられる。公式例: open a PR and keep it green until merge。GitHub の CI 待ちは Checks が全部終わるまで1つの結果で、pending の Check が1つでも全体が届かない。公式は action_required(要対応)で完了させる(follow-up-loop)
  • `@cursor autofix`(Agent 作成 PR): GitHub Actions の失敗だけを自動追従する別機能。Subscriptions より狭い範囲

マージまで任せるレシピ(/autopilot と3道具)

道具は別物ですが、組み合わせると『PR を出してからマージまで』をほぼ任せられます。いちばん簡単な入口は `/autopilot` です。

  • ① いちばん簡単: チャットで `/autopilot`。開いた PR の指摘・コンフリクト・Checks を見守って直す(公式 Agent Skills)
  • ② 起動時: この PR だけを待つ Subscriptions 付きで依頼(上のコピペ用、または `/subscribe`)。いまの公式 GitHub 待ちは1つの PR とブランチの CI。保管庫横断は Automations
  • ③ PR 作成後: GitHub またはスマホで auto-merge をオン
  • ④ 必要なときだけ: Agent 作成 PR で CI が赤いとき `@cursor autofix on`(Teams)

マージボタンがグレーのとき

Merge(反映)ボタンが押せない・グレー表示のときは、だいたい次のどれかです。Checks が赤、behind 表示、コンフリクト、必須レビュー未承認、ブランチ保護ルール、あなたにマージ権限がない。

このレッスン冒頭の図は、6つの原因を一覧にしたものです。Checks が緑でも、④⑤⑥(承認・保護・権限)で止まることがよくあります。auto-merge をオンにしても、条件が揃うまで反映は始まりません。Origin で積み重なった子は、いちばん下の開いている PR になるまで待つことがあります(末尾の順番待ち)。親を先に反映した子が needs_restack で止まるのは、この6つとも順番待ちとも別です(末尾の積み直し)。

behind なら Update branch(pull-request-deep の behind 節)。コンフリクトなら Agent に解消依頼。CI 赤なら pull-request-deep の CI 3択図どおり。承認が足りないときはレビュアーを足すか、詳しい人に相談しましょう。Origin 上の PR でもコンフリクトは画面に出ます(公式 Origin pull requests)。

公式の GitHub 連携では、Cursor アプリがブランチ保護や必須チェックのルールを読み、マージ可能かどうかを判断します。表示が想定と違うときは、カスタムリポジトリロールの影響も accounts-setup で確認できます。Origin 上で作った保管庫では、同じ役割が Settings の Rules and Protections(マージ時・push 時の ruleset)です。レビュー必須のとき、書き込み権限のある人の Request Changes は、その人が Approve するか、書き込み権限のある人がレビューを取り下げないとマージを止めます。GitHub 同期の保管庫は GitHub 側のブランチ保護のままです(公式 Origin settings / pull requests)。

CI が赤くなったとき(Agent 作成 PR)

Cloud Agent が作った PR では、GitHub Actions の失敗を Agent が自動で直しにいくことがあります(いまは Teams 向け。個人プランは追従予定)。Desktop の PR トレイで黄色の Action Required は、人の承認待ちです。CI が赤い CI Failing とは別です(pull-request-deep 末尾。公式 changelog 3.23)。

自動追従(autofix)が走らない典型例は、公式 capabilities では次のとおりです。

  • 人が後から push した
  • あなたが追加メッセージ(follow-up)を送った
  • 同じ Check が取り込み先(base)でも既に赤い
  • 同じ PR で CI 失敗の自動修正が10回に達した

コミットの Verified(署名)

Cloud Agent が付けたコミットには、Cursor 側の署名が自動で付きます。GitHub / GitLab では Verified バッジとして見えます。はじめて見ると『誰かが特別な鍵を入れた?』と不安になることがありますが、正規の Cloud Agent 実行なら想定どおりです。

チームがブランチ保護で『署名付きコミット必須』にしていても、Agent の PR はそのまま条件を満たせます。追加の設定は不要です。

成果物を PR 本文に載せる設定

スクショなどの成果物は Agent 画面で見る以外に、GitHub の PR 説明文へ埋め込む設定もあります(Cloud Agents ダッシュボードの Allow posting artifacts to GitHub)。レビュー担当が GitHub だけ見て判断するチーム向けです。

埋め込まれた画像は、長い推測しにくい URL の公開リンクになります(GitHub の画像表示の仕組み上、認証なしで見られる形です)。画面に秘密情報や個人情報を映していないか、埋め込み前にもう一度確認しましょう。

PR のリンクをコピーする

Agent が Pull Request を開いたあと、パネルやサイドバーのコピーメニューに Copy PR Link があります。いつもの確認先(GitHub など)の URL が入り、短い通知が出ます(公式 changelog)。

チャットの履歴を全部送らなくても、このリンクだけで同僚に確認を頼めます。送る前に、相手にもその保管庫の権限があるかを確認してください(first-cloud-agent の URL 共有)。

Origin の反映済み一覧と Gate

Origin 上で作った保管庫の Pull Requests 一覧には Merged タブがあります。件数も出ます。検索ボックスの `is:merged` でも、反映済みだけに絞れます(公式 Origin web、Week of Sep 28, 2026)。

確認してほしい人をメールで指名できます。Agent に『このメールの人にレビューをお願いして』と頼むか、origin pr edit --add-reviewer です。候補が一人に決まらないと失敗し、誰を指名したか表示されます。コメントを残すと、そのコメントを開く URL も返ります(公式 Origin CLI、2026-10-01)。

『まだ何が足りないか』は origin pr requirements です。必須の門・承認・人だけが触れられる道・Code Review Gate・スタックの止まりが、いまの先頭コミット向けに並びます。この PR に付いている Cloud Agent を見るなら origin pr view --agents です(公式 Origin CLI、2026-10-06)。

Gate というレビュー用 Check は、CI の成否には数えません。origin pr checks の待ち・失敗・無しの判定からも外れます。対象のルールが読めないときの CI / 承認表示は unknown です。赤いテスト失敗とは別物です。

Origin が混み合っているときは、CLI が待ってからやり直します。『Origin rate limit reached; retrying in Ns.』と出ても、壊れたサインではありません。

チームの IP 許可リストは、人のサインインに効きます。アプリ、サービスアカウント、Agent は止めません(公式 Origin web)。Agent が社内ネットから届かない、という症状とは切り分けてください。

Origin 上の Bugbot の Check 名は `Cursor / Cursor Bugbot` と `Cursor / Cursor Bugbot Autofix` です。GitHub の `Cursor Bugbot` とは表記が違います。必須 Check のルールに Bugbot と書いてあれば、そのままマッチします。エラーやレビュー投稿の失敗は失敗です(GitHub の指摘時の中立とは別)。新しい push でキャンセルされた実行は cancelled なので、必須 Check を満たしません(公式 Bugbot release notes。automations 末尾)。

いまのターンだけ見る(Last Agent Turn)

Desktop で確認するとき、長い会話の全差分を最初から追う必要はありません。Changes(変更)タブに Last Agent Turn という範囲があります。直近のターンで直したファイルだけが出ます(公式 changelog 3.22)。

ターン末尾の Review や、そこからファイルをクリックすると、同じ範囲で Changes が開きます。PR の Files changed は提案書全体、Last Agent Turn は『いま直したところ』です。確認メモはこれまでどおり、要約 → 意図せぬ変更 → Checks の順で大丈夫です。

  • いま直したところ: Changes の Last Agent Turn
  • 提案書全体: PR の Files changed
  • ターン末尾の Review からも、その範囲で開く

直すときに下書きとコミットを守る

Bugbot の指摘から Fix with Agent を押しても、入力欄に書いていた下書きは消えません。次に送る文へ、Bugbot の報告がもう一度付くこともありません(公式 changelog 3.24 / Agents Window)。cursor.com の提案書で、このボタンがどの会話への追記になるかは、このレッスン末尾です。下書きが残る話とは別です。

Review Changes でコミットをキャンセルしても、そのあと Pull Request は開きません。以前は、やめたのに PR まで進むことがありました。

同じ場所のスクショや動画を撮り直したときは、会話に出る内容が新しいものに替わります。古いデモのまま見えない、ということは減っています。音を消したままにしたいかは、これまでどおり Mute です。

会話に出る PR の印の Copy Link は、リンクをコピーするだけです。押したときに PR のページは開きません。パネルの Copy PR Link(このレッスンの前の節)とは、入口が別です。

  • Fix with Agent: 下書きは残る。Bugbot の報告は次の送信に付かない
  • コミットをやめる: そのあと PR は開かない
  • 撮り直したスクショと動画は、新しい内容に替わる
  • PR の印の Copy Link はコピーだけ。ページは開かない

積み重なった PR の見え方(スタック)

いくつかの Pull Request が親子のように積み重なっているとき、Agents Window の PR トレイと、PR タブのスタック案内に並びます(公式 changelog 3.24 / Agents Window)。

閉じた PR は1件ずつ並ばず、「N closed」(閉じた N 件)の1行に畳まれます。消えたわけではありません。行を開けば中身を見られます。

スタックの一部だけが、いま見ている Project に属していても、まとまりは分かれません。隙間は「1 PR not in this project」(この Project に入っていない PR が1件)のような行で示されます。別の Project の PR が欠けた、という表示です。

Origin の PR を反映するとき、その下に開いている PR も一緒に本線へ入る場合、ボタンは「Merge N PRs」と出ます。注記は、1つのコミットとして入る、です。N 件がばらばらのコミットで入る、という意味ではありません。Squash merge と同じく、まとめて1つになります。押す前に、どの PR が一緒に入るかをスタック案内で確認してください。

PR タブのメニューに View on Web があります。ブラウザの PR ページを開く入口です。Fix CI のような追記の印は、どの PR に対する操作かが名前に出ます。別の PR を直しているつもりで押さないための印です。

  • 閉じた PR: 「N closed」に畳まれる。消えていない
  • 一部だけ Project に入っている: まとまりは残る。隙間は「1 PR not in this project」
  • 「Merge N PRs」: 開いている下の PR も一緒に、1つのコミットとして入る
  • View on Web: ブラウザの PR を開く
  • Fix CI などの印: どの PR 向けかが名前に出る

親を先に反映したあと、子が積み直しになる

親子のように積み重なった Pull Request を、下のものと一緒に「Merge N PRs」で入れる方法は、前の節のとおりです。親だけを先に squash(変更を1つにまとめる反映)で本線へ入れ、子の向き先をその本線へ付け替えると、子が反映できなくなることがあります。

Origin では、この状態を needs_restack(積み直しが必要)と呼びます。マージを許す保管庫で起きます。子の土台が、いまの本線とずれているためです。このまま入れると、親が一度消した変更を子が呼び戻すことがあるので、反映は拒否されます。ボタンを連打しても入りません(公式 Origin API changelog 2026-10-12)。

直し方は、子に入っている自分の変更だけを、いまの本線の先へ積み直すことです。自分で git を操作しなくて大丈夫です。Agent に『この PR の自分の変更だけを、いまの本線の先へ積み直して。親が消した変更は戻さないで』と頼んでから、もう一度反映を見てください。

  • 一緒に入れる: 「Merge N PRs」(前の節)。1つのコミット
  • 親だけ先に squash で入れた: 子が needs_restack になることがある
  • 連打では入らない。自分の変更だけを本線の先へ積み直す
  • 図の①〜⑥(赤・behind・コンフリクト・承認・保護・権限)とは別の止め

大きな差分は、中身が見えない警告

Cloud Agent が直したファイルが、画面に出しきれないほど多いとき、Review Changes は『ファイルの中身が見られない』と警告します。Apply(手元へ取り込む)は、その状態では押せません。以前は、中身が空のファイルとして書き込まれることがありました(公式 changelog 3.23)。

警告の意味は、ファイルが多すぎて中身を出せていない、です。変更がゼロ件だった印ではありません。空のファイルを自分でコピーして埋めないでください。差分の全体は、Pull Request の Files changed で見ます。まだ大きいときは、Agent に『この変更を小さな PR に分けて』と頼む方が安全です(`/split-to-prs`)。スマホの大きな差分がファイル名と行数の一覧になるのも、中身を全部は出さない側です。

  • 中身が見られない: ファイルが多すぎる警告。Apply は止まる
  • 空のファイルで埋めない。PR の Files changed を見る
  • まだ大きい: Agent に小さな PR へ分けるよう頼む

積み重なった子の auto-merge は、いちばん下まで待つ

Origin で auto-merge(条件が揃ったら自動反映)をオンにしても、親子のように積み重なった子の Pull Request は、Checks が緑でもすぐには入りません。そのスタックで、いちばん下の開いている PR になってから入ります(公式 Origin API changelog 2026-10-13)。

親がまだ開いているあいだは、順番待ちです。承認が足りない印でも、壊れた印でもありません。親が反映されるか閉じると、子がいちばん下になります。そのとき、Checks・承認・behind・コンフリクトが揃っていれば入ります。

needs_restack(積み直し)とは別です。積み直しは、親を先に反映したあと土台がずれて、反映そのものが拒否される止めです。こちらは、土台は合っていて、上に開いている PR があるあいだ待つだけです。

反映のしかたも、ルールで限られることがあります。Origin の ruleset が通常のマージだけ、squash だけ、またはその両方だけを許していると、それ以外のボタンは拒否されます。方法を指定しない反映は、許されている方で入ります。どちらが許されているか分からなければ、詳しい人に聞いてください。

すでに auto-merge がオンの PR で、もう一度オンにすると、そのときの方法で入れ直す予約になります。閉じた PR や、すでに反映した PR ではオンにできません。

  • 積み重なった子: いちばん下の開いている PR になるまで待つ
  • Checks が緑でも、上に親が開いていればまだ入らない
  • needs_restack は土台のずれ。こちらは順番待ち
  • 許されていない反映のしかた(squash だけ / 通常のマージだけ)は拒否される
  • 閉じた PR・反映済みの PR では auto-merge をオンにできない

行の差分の前に、案内を読む(Code Tours)

Origin の Pull Request を開くと、4つ目のタブは Changes です。GitHub でいう Files changed に相当します。別の5つ目のタブがあるわけではありません。Changes の中に Diff(行ごとの差分)と Tour(案内)の切り替えがあります。Tour を選ぶか、キーボードの T を押します。もう一度 T で差分に戻ります(公式 Origin pull requests / Code Tours)。

案内は、その提案書のためだけに書かれます。小さな直しは数文、大きな変更は部分ごとの歩き方です。たいてい最初に、その場所をまだ知らない人向けの『何を、なぜ変えたか』が出ます。そのあと、関連する変更をグループにして、コードの横で説明します。ほかのコードが頼りにしている動きなど、よく見てほしいところも指します。点線の下線が付いた言葉は、マウスを載せるか、キーボードで焦点を当てると短い説明が出ます。説明文や、作った Cloud Agent のスクショ・録画が出ることもあります。Agent が提案書を書いたときは、なぜそうしたか、何に注意するか、何を試したか、という Agent のメモが案内に入ることがあります。

事前に書かれるのは、Origin 上で作った、チームが持つ保管庫だけです。下書きを含む提案書を開いたときと、新しいコミットが push されたときに、裏側で書かれます。たいてい、最初に確認する人が見る前に用意されています。すでに書いてある案内を読むだけでは、利用量は減りません。事前に書いた分も、利用量には入りません。

開いたときにまだ無いとき、自分で別の案内を頼んだときは、その場で書かれます。節ができていくのを読みながら待てます。これは Agent への依頼と同じように、利用量に入ります。その場で書かせるには有料プランが要ります。無料、または個人プランの試用中は、すでに書いてある案内を読むだけです。新しい契約の Plus には Origin 自体がありません(accounts-setup のいまの契約)。

GitHub から同期した保管庫の Pull Request にも案内は出ますが、機能は少なめです。事前には書かれません。題の横の Generate custom tour で、ハイライトから始める項目もありません。見るファイル、深さ、自分の指示は使えます。

誰かが push すると、そのコミットの案内を裏側で書き始めます。いま読んでいる案内はそのままです。Diff / Tour の横に Updating… が出ます。最新を見ているなら、できあがると差し替わります。古い版を見ているなら See latest を押します。書きかけのコメントがあると、移る前に確認されます。古い版で、その版に無いコードへのコメントは Not in this version と出ます。

大きすぎる提案書は Too large for a tour と出て、View files で差分に戻ります。小さく分けると、それぞれに案内が付きます。途中で止まったら Couldn't generate the tour の下の Retry です。続いても失敗するときは、有料プランかを確認します。

左上の短い線で、案内の節の一覧へ飛べます。見出しの横のリンクで、その節だけを共有できます。節のチェックを付けると、その節のファイルを見たことになります。Diff 側の進捗も同じです。テストのファイルは最初から畳まれていて、確認したいコードが先に出ます。削除、生成、バイナリのファイルも、最初は畳まれていることがあります。

題の横の Generate custom tour から、ハイライトから始める、見るファイルを選ぶ、深さを変える、自分の指示を足す、ができます。ファイルの上の版の選びで、ある版、あるコミット、ある範囲に案内を合わせられます。Changes since your last review は、前回見てから増えた分だけです。

節の見出しの横の + で、ページ下の Ask Cursor にその節を足してから質問できます。文章を選んで Add to chat、または Cmd I でも聞けます。チャットが使える提案書で出ます。その提案書で働いている Cloud Agent に、節の書き直し、スクショや録画を足すこと、案内全体の作り直しも頼めます。この作業は、その Agent の利用量です。

ファイルが3つより多い提案書では、最後の節のあとに What next? が出ることがあります。前回からの変更、自分が持つファイル、詳しい版、別の案内(Something else…)、案内へ画像や表を足す(Add media to this tour)などです。読み終わったあとの Is this tour helpful? は、親指の上下と、任意のコメントです。

案内のプライバシーは、保管庫の持ち主(チームまたは人)の Privacy Mode に従います。Origin のほかの機能と同じです。案内を書くときは、提案書の差分と説明文がモデルへ送られます。案内は提案書と一緒に保存され、その提案書を見られる人は読めます。

  • タブは4つのまま。Changes の中で Diff と Tour。T で行き来
  • 読むだけ、事前に書いてある案内は利用量に入らない
  • その場で書く、別の案内を頼む、Agent に書き直させる、は利用量が減る
  • 事前に書かれるのは、Origin 上で作ったチームの保管庫だけ(下書きを含む)
  • GitHub 同期の PR は機能が少ない。ハイライトから始めるは無い
  • 新しいコミットは Updating…。最新なら差し替わる。古い版は See latest
  • 大きすぎる: Too large for a tour。View files で差分へ戻る
  • 無料と個人の試用中は、すでに書いてある案内を読むだけ

自分が開いていない PR の説明は、下に足す

Cloud Agent に、自分が開いていない Pull Request の説明を直して、と頼むと、以前は断りました。いまは、GitHub の PR でも、Cursor がホストしている PR(このサイトの Origin 上の提案書)でも、すでにある説明の下に足します。作者が書いた文を消して置き換えません。説明が空なら、その空欄を埋めます(公式 Cloud Agents release notes、Week of Oct 12, 2026)。

説明の下に知らない文が増えていたら、先に2つを分けます。あなたが頼んだ追記は、この節の動きです。レビューのたびに自分で書き換わる要約は、Bugbot の PR Summary です。既定で説明文へ追記されます(automations の Bugbot の要約と直し方)。作者の文は、上に残っているかを見てください。

保管庫が1つだけの環境で動いている Agent は、Pull Request を作るときも、すでにある PR を扱うときも、依頼文に保管庫の名前を書かなくてよくなりました。この『名前は要らない』は、保管庫が1つの環境だけの話です。やり終えた PR の操作は、会話の中で完了と見えます。終わったあとも、その操作だけが進行中のままにはなりません。

  • 自分が開いていない PR: 既存の説明の下に足す。空なら埋める。上書きしない
  • Bugbot の要約とは別。頼んだときだけ足す
  • 保管庫が1つの環境: PR の作成と管理に、保管庫名は不要
  • やり終えた PR の操作は、会話で完了と見える

PR ページの Agent 一覧は、入力欄のすぐ上

cursor.com の Pull Request ページには、浮いた枠の中に Agent の一覧があります。開く場所は、入力欄のすぐ上です。いま作業中の件数と、注意が必要な件数が分かります。一覧がページの下や、別の画面にある、と探さなくて大丈夫です(公式 Cloud Agents release notes、Week of Oct 12, 2026)。この一覧の中の会話が Desktop の Agents Window と同じ並びになった話は、first-cloud-agent 末尾です。

いま開いている Agent は止まっているのに、その下の Agent がまだ動いているとき、見出しは Waiting on(待っている)と、その下の Agent を指します。故障で止まったのではありません。開いている Agent が、下の仕事の終わりを待っています。

一覧がいつまでも読み込みのままなら、以前はそう見えました。いまは Retry(やり直す)の案内が出ます。その案内を押します。何分も白い画面のままにしないでください。案内(Tour)の Couldn't generate the tour の下の Retry とは別です。こちらは、PR ページの Agent 一覧が読み込めなかったときの案内です。

Privacy Mode(Legacy)が Cloud Agent を止めているときも、一覧がそのことを伝えます。読み込み失敗とは別です。Retry を押しても、この止めは解けません。Cloud Agent には、保存しない旧モードではなく、いまの Privacy Mode(no training)が要ります。画面の名前の見分けは、environments-and-secrets のプライバシーの節です。Fix with agent を押したときに、一覧のいちばん上へ行くとは限りません。どの会話への追記かは、このレッスン末尾です。

  • 一覧は入力欄のすぐ上。作業中の件数と、注意が必要な件数
  • Waiting on: 開いている Agent は止まっている。下の Agent がまだ動いている
  • 読み込みが終わらない: Retry。Tour の生成失敗の Retry とは別
  • Privacy Mode(Legacy): Cloud Agent を止める案内。Retry では始まらない

Cloud Agent が開く PR は、最初から Ready

Cloud Agent が新しく開く Pull Request は、下書き(Draft)ではなく、最初から確認できる状態(Ready for review)です。Projects のワーカーが開く PR も同じです。あなたか、依頼の文が下書きを頼んだときだけ、下書きになります。頼んでいないのに最初から Ready で開いても、故障ではありません(公式 Cloud Agents release notes、Week of Oct 19, 2026)。

Origin CLI で自分の手で作る PR は、これまでどおり既定が Draft です。このレッスンの冒頭の話で、Cloud Agent が開く PR とは別です。Ready は『見てよい』であって、『もう本番に入った』ではありません。中身を見てから反映します。

下書きのまま出したくないときは、コードベース設定(codebase settings)の Pull requests に、Never open PRs as drafts があります。これをオンにすると、あなたが開く新しい PR も、Agent が開く新しい PR も、下書きを頼んでも Ready のままです。下書きで出したい案件では、このスイッチを先に見てください。

最初から Ready で開くと、下書きをきっかけにしている Automation には入りません。GitHub の『Draft が開いたとき』だけを待っていると、通常の Cloud Agent の PR は通りません。『Ready の PR が開いたとき』側が対象です(automations の Draft と Ready のちがい)。下書きを対象外にしている自動レビューは、Ready なら対象側です。下書きのままレビューを遅らせたいときは、依頼に『下書きで開いて』と書き、Never open PRs as drafts がオフであることも確認します。非公開の Origin の提案書に書いたコメント、返信、レビューの末尾のボタンは、次の節です。

  • Cloud Agent と Project のワーカー: 既定は最初から Ready。下書きは、あなたか依頼が頼んだときだけ
  • Origin CLI で手で作る PR: 既定は Draft のまま。この節とは別
  • Never open PRs as drafts: 下書きの依頼があっても、あなたと Agent の新しい PR は Ready
  • Ready は確認してよい印。反映済みではない
  • Linear の課題から始めた実行: 提案書の末尾の一行で、マージ時にその課題が閉じる。出方は first-cloud-agent 末尾

非公開 Origin のコメントは、末尾が Open in Web

非公開の Origin の Pull Request(外に出していない提案書)に、Cloud Agent がコメント、返信、またはレビューを書くと、その文の末尾に Open in Web のボタンが付きます。これがコメント末尾のボタンです。押すと、その Agent の実行が開きます。コメントの文章だけでなく、Agent が何をしたかを、その場から見られます(公式 Cloud Agents release notes、Week of Oct 19, 2026)。

レビューする人が、提案書のコメントから Agent の作業へ戻るためのボタンです。故障で付いた印ではありません。コメントにも、返信にも、レビューにも、末尾に付きます。

公式が書いているのは、非公開の Origin の提案書です。公開の Origin や、GitHub のコメントにも同じボタンがある、とはこの一文だけでは言えません。無いから壊れている、とも断定しません。

Microsoft Teams の起動カードの Open in Web / Open in Desktop とは別です。あちらは、個人チャットやグループチャットの続きを Web か Desktop で開く入口です(first-cloud-agent の Microsoft Teams 節)。こちらは、非公開 Origin のコメントの末尾に付く、Agent の実行へのボタンです。

Open in Cursor とも別です。Open in Cursor は、Desktop の Agents Window でその Agent を開きます。View on Web は、PR のメニューからブラウザの提案書を開く入口です。コメント末尾のボタンは、提案書の上から、その Agent の実行へ移ります。cursor.com の提案書で、直すボタンがどの会話への追記になるかは、次の節です。

  • 付く場所: 非公開 Origin の提案書に、Cloud Agent が書いたコメント、返信、レビューの末尾
  • 押すと: その Agent の実行が開く。作業の中身へ戻れる
  • 公開の Origin や GitHub に同じボタンがあるかは、この一文では断定しない
  • Teams の起動カード、Open in Cursor、View on Web とは別

Fix with agent は、出した側の会話へ戻る

cursor.com の Pull Request ページで Fix with agent(この提案書を直して、と Agent に戻す)を押すと、出した側の会話へ戻る、です。その提案書を開いた Agent への追記です。あるいは、その提案書のうえで、自分の最近の会話へ戻る、です。あなたがいちばん最近動かしていた Agent への追記です。公式の英語は follow up the agent that opened the pull request, or your most recently active agent on it です。出した側と、自分の最近と、どちらが先に選ばれるかは、この一文では書いてありません(公式 Cloud Agents release notes、Week of Oct 19, 2026)。

以前は、一覧のなかで時刻が新しい Agent を開いていました。いまは、新しい順の会話は選ばない、です。一覧の上が新しく見えても、ボタンの行き先はそれとは限りません。開いた会話がこの提案書の仕事かを、送る前に見てください。

同じ種類の操作、と公式は書いています(similar actions)。ボタン名の一覧は、この一文にはありません。Fix with agent と出ている操作は入ります。名前の違うボタンまで同じ、とは断定しません。

これは追記です。別の新しい Agent を作り始める、とは書いてありません。出した側も、その提案書で自分が動かした Agent も無いときに何が起きるかも、書いてありません。そのときは、入力欄のすぐ上の一覧で、どの会話が開いたかを見てから送ってください。

出した側は、あなたが始めた Agent とは限りません。同僚の Agent がその提案書を開いたなら、出した側はその同僚の Agent です。自分の最近は、あなた自身がその提案書のうえで動かしていた Agent です。同僚が直前に動かしていた Agent、とは書いてありません。

対象は cursor.com の Pull Request ページです。iPhone のレビュー画面の Fix with Agent、Bugbot の指摘から押す Fix with Agent、GitHub.com の画面まで同じかは、断定しません。下書きが残る話は、このレッスンの「直すときに下書きとコミットを守る」です。一覧の Waiting on は、下の Agent を待っている見出しで、このボタンの行き先とは別です。

  • 出した側の会話へ戻る: その提案書を開いた Agent への追記
  • 自分の最近の会話へ戻る: その提案書であなたがいちばん最近動かしていた Agent
  • 新しい順の会話は選ばない。一覧の並びとは別
  • どちらが先か、Agent が無いときの動きは、このノートに無い
  • iPhone、Bugbot の指摘、GitHub.com までは断定しない

理解チェック

  • PR が『まだ本番に入っていない提案』だと説明できる
  • Origin 上の PR は Activity / Commits / Checks / Changes の4タブで、4つ目は GitHub の Files changed に相当すると知っている
  • Origin CLI の PR は既定が Draft で、確認後に Ready にすると知っている
  • Origin 上の PR で Checks が古いままなら refresh を疑える
  • Origin 上の PR がマージできないときは Rules and Protections を疑える
  • Origin でレビュー必須のとき、書き込み権限のある人の Request Changes がマージを止めると知っている
  • Origin 上の PR でも条件が揃ったらマージ(GitHub の auto-merge と同じ役割)があると知っている
  • Origin の PR にまだ足りないものは origin pr requirements、付いている Cloud Agent は origin pr view --agents だと知っている
  • マージ前に見る観点を3つ以上言える
  • 『なぜこの変更が入ったか』は `/cursor-blame` で調べられると知っている
  • 成果物(スクショ/動画)を確認の手がかりに使える
  • Agents Window の動画は Mute で静かにでき、次の本もその状態から始まると知っている
  • 成果物は PR に紐づくが、GitHub 説明文への埋め込みは Allow posting が別設定だと知っている
  • PR に埋め込んだ成果物が公開 URL になりうることを知っている
  • Agent のコミットに Verified が付くのは署名コミットだと説明できる
  • PR 確認メモの型で、次の一手(マージ / 追加指示 / 相談)を選べる
  • Squash merge が『変更を1つにまとめて反映する』方式だとざっくり説明できる
  • auto-merge と Subscriptions と `@cursor autofix` の役割の違いを説明できる
  • `/autopilot` が開いた PR を見守って直す近道だと知っている
  • Subscriptions と auto-merge を組み合わせてマージまで任せる手順を説明できる
  • マージボタンがグレーのとき、behind・コンフリクト・CI・承認・権限のどれを疑うか分かる
  • Checks が緑でも、承認・保護・権限でマージできないことがあると知っている
  • コンフリクト表示のとき Agent に解消を依頼できると知っている
  • Agent 作成 PR の CI 自動修正を `@cursor autofix off` / on で切り替えられると知っている
  • Bugbot Autofix(指摘を直す)と `@cursor autofix`(CI を直す)は別だと知っている
  • `/review-bugbot` した同じ差分の PR では、保管庫側の Bugbot が再実行を飛ばすことがあると知っている
  • Desktop の手元変更を読む `/agent-review` は、PR の Bugbot とは別だと知っている
  • Dashboard → Cloud Agents → My Settings の Automatically fix CI Failures で autofix 全体を止められると知っている
  • Teams 以外では autofix の自動追従が使えないことがあり、Subscriptions や明示依頼が代替だと知っている
  • autofix が自動追従しない4条件(人の push・追加メッセージ・base でも赤・10回上限)を説明できる
  • コピーメニューの Copy PR Link で、Agent が開いた PR の URL を取れると知っている
  • Origin の反映済み PR は Merged タブか is:merged で見つかると知っている
  • Origin の Gate Check は CI に数えず、unknown はルール未読だと知っている
  • Origin の PR はメールでレビュアーを指名できると知っている
  • Origin 上の Bugbot Check 名は Cursor / Cursor Bugbot で、エラーは失敗だと知っている
  • PR トレイの黄色の Action Required は承認待ちで、CI Failing とは別だと知っている
  • Desktop の Changes タブを Last Agent Turn にすると、直近のターンだけ見られると知っている
  • Bugbot の Fix with Agent でも入力欄の下書きは残り、報告は次の送信に付かないと知っている
  • Review Changes でコミットをやめても、そのあと PR は開かないと知っている
  • スクショや動画を撮り直すと、会話には新しい内容が出ると知っている
  • 閉じた PR は「N closed」に畳まれ、消えたわけではないと知っている
  • 「Merge N PRs」は、開いている下の PR も1つのコミットとして入る表示だと知っている
  • スタックの隙間「1 PR not in this project」は、この Project に入っていない PR だと知っている
  • 親を先に squash で反映した子が needs_restack になることがあり、積み直すまで反映できないと知っている
  • Origin で積み重なった子の auto-merge は、いちばん下の開いている PR になるまで待つと知っている
  • needs_restack は土台のずれで、auto-merge の順番待ちとは別だと知っている
  • Origin で許されていない反映のしかた(squash だけ / 通常のマージだけ)は拒否されると知っている
  • Review Changes で中身が見えない差分は、変更ゼロではなく Apply が止まる印だと知っている
  • Origin の Changes で Tour を選ぶか T を押すと、行の差分の前に案内を読めると知っている
  • すでに書いてある案内を読むだけでは利用量は減らず、その場で書くと Agent の依頼と同じだけ減ると知っている
  • 案内を事前に書くのは Origin 上で作ったチームの保管庫だけで、GitHub 同期はハイライトから始めるが無いと知っている
  • Too large for a tour は大きすぎる印で、Updating… は新しいコミットの案内を書いている最中だと知っている
  • 自分が開いていない PR の説明は、既存の文の下に足され、空なら埋まると知っている
  • 説明の追記は作者の文を消さず、Bugbot の PR Summary とは別だと知っている
  • 保管庫が1つの環境では、PR の作成と管理に保管庫名は要らないと知っている
  • やり終えた PR の操作は、会話の中で完了と見えると知っている
  • cursor.com の PR ページでは、Agent 一覧が入力欄のすぐ上に開き、作業中と注意が必要な件数が分かると知っている
  • Waiting on は、開いている Agent が止まっていて下の Agent がまだ動いている印だと知っている
  • 一覧の読み込みが終わらないときは Retry で、Tour の生成失敗の Retry とは別だと知っている
  • Privacy Mode(Legacy)と出たら Cloud Agent が止まっていて、Retry では始まらないと知っている
  • Cloud Agent と Project のワーカーが開く PR は、頼んでいなければ最初から Ready だと知っている
  • Ready は見てよい印で、反映済みではないと知っている
  • Never open PRs as drafts がオンだと、下書きの依頼があっても新しい PR は Ready のままだと知っている
  • Origin CLI で手で作る PR の既定 Draft は、Cloud Agent が開く PR とは別だと知っている
  • 非公開の Origin の提案書では、Cloud Agent のコメント、返信、レビューの末尾に Open in Web が付くと知っている
  • コメント末尾のボタンは、その Agent の実行を開き、Teams の起動カードや Open in Cursor、View on Web とは別だと知っている
  • 公開の Origin や GitHub のコメントにも同じボタンがあるかは、この一文では断定しないと知っている
  • cursor.com の提案書で Fix with agent は、出した側の会話へ戻る、か、自分の最近の会話へ戻る、だと知っている
  • 新しい順の会話は選ばない。どちらが先か、iPhone や GitHub.com まで同じかは断定しないと知っている

開いただけでは「済」になりません。チェックできたら押してください。

実践(ぜひやってみましょう)

実在する PR(Agent が作ったものか、過去のチームの PR)を1つ開き、コピペ用の確認メモを埋めてみてください。behind やコンフリクト表示があれば、Update branch か Agent への解消依頼を試してみましょう。Desktop なら Changes を Last Agent Turn にして、いま直したところだけ先に見てみてください。動画があれば Mute も一度押してみてください。Fix with Agent のあとは、下書きが残っていないか入力欄も見てください。「Merge N PRs」と出たら、1つのコミットとして入る注記を読んでから押してください。閉じた PR は「N closed」です。親だけ先に反映して子が needs_restack と出たら、積み直しの節の依頼文を一度書いてみてください。積み重なった子の auto-merge が緑のまま動かないときは、末尾の順番待ちを見て、親がまだ開いていないかを先に確認してください。Review Changes が『中身が見られない』と出たら、Apply は押さず PR の Files changed を見てください。Origin の PR なら、Changes の Tour を一度開いて、行の差分の前に案内を読んでみてください。自分が開いていない PR の説明を直して、と頼むなら、作者の文が残って下に足されることを先に知っておいてください。空の説明なら、その欄が埋まります。cursor.com の PR ページを開いたら、入力欄のすぐ上の Agent 一覧も一度見てください。Waiting on なら下の Agent の終わりを待ち、Retry なら読み込みをやり直し、Privacy Mode(Legacy)と出たらプライバシーを先に切り替えてください。Cloud Agent の PR が最初から Ready でも、反映前です。下書きで出したいのに Ready なら、「Cloud Agent が開く PR は、最初から Ready」の Never open PRs as drafts を見てください。非公開の Origin の提案書で、Agent のコメントの末尾に Open in Web と出たら、末尾の節を見て、押してその実行を開いてください。Teams の起動カードの Open in Web とは別です。cursor.com の提案書で Fix with agent を押したら、末尾の節を見て、開いた会話がその提案書の仕事かを確認してから送ってください。時刻が新しいほうの Agent とは限りません。反映まではしなくて大丈夫です。

このレッスンで出てくる用語

全部覚える必要はありません。気になる言葉だけ開いてみてください。

用語集を全部見る →

いま身についている開発者スキル

コードレビュー / リリース判断