学習ゴール
- ブランチ→小コミット→PR→レビューの流れをCursor上で回し、AI生成diffを安全に取り込める。
git diffでノイズ(整形だけ)を検知し、レビュー観点をチームと共有できる。
前提知識
git clone,checkout -b,commit,pushがターミナルまたはGUIで実行できること。- リモート(GitHub/GitLab等)へのPR体験があるとスムーズです。
キーコンセプトと用語
- フィーチャーブランチ:本線を汚さない作業用ライン。
- アトミックコミット:論理単位が一つにまとまったコミット。
- PRサイズ:小さいほどレビュー容易。AIほど大きなdiffに注意。
- blame/履歴:いつ誰がどの行を変えたかを追う。
手順(ステップバイステップ)
- 最新mainを取得し、ブランチを切る。
- AI変更前に現状コミット(WIPでも可)し、安心のロールバック地点を作る。
- 小さく編集:Composerでもファイル単位で区切る。
- こまめに
git diff:意図しないファイルが増えていないか。 - コミットメッセージ:Whyを1行、必要なら本文にWhat。
- 自己レビュー:diffを音声読み上げ気分で読むとミスに気づきやすい。
- PR作成:スクリーンショットまたは確認手順をdescriptionに。
実践ミニ演習
- 演習1:わざと2ファイル変更し、1ファイルだけをステージして部分コミット。
- 演習2:formatterのノイズdiffを1回作り、
--statで視覚確認。 - 演習3: revert コミットを1回行い、手順をメモに残す。
セルフチェックリスト
- [ ] 機能ブランチで作業している
- [ ] 秘密ファイルがコミットに含まれていない
- [ ] diffがレビュアーに説明できる大きさ
- [ ] CI(あれば)が緑
- [ ] マージ後のデプロイ手順を書いた
つまずきポイントと対処
- コンフリクト地獄 → 長命ブランチをやめ、日次でmain取り込み。
- 巨大diff → AIに「分割PR計画」を先に書かせる。
- 誤コミット →
git resetの型をチートシート化(共有リポでは禁止操作に注意)。
深掘り:レビューコメントの型
「意図」「リスク」「テスト手順」の3点をコメントテンプレにすると、AI協働チームでも非同期レビューが速くなります。
次のステップ
複数人でCursorを使うなら チーム運用 で責任分界とLintポリシーを固定します。
運用ノート:マルチリポジトリとモノレポ
サービスが分離していると、Composerの変更が別repoへ波及しやすくなります。契約テストやスタブを先に置くと安全。モノレポではパッケージ境界でPRサイズを制御し、CI時間増と引き換えにレビュー負荷を下げます。リリースブランチ運用では、AI生成コミットでもタグとリリースノートのルールを破らないことを徹底。深夜マージは人のレビューが薄れるので、原則禁止かダブルチェックを敷く。
(学習の定着)
組織学習の観点では、週次15分の振り返りをカレンダーに固定し、うまくいった依頼文や依頼テンプレは共有ドライブへコピーして資産化します。四半期ごとに公式の利用規約と社内ポリシーを突き合わせ、差分があれば短いチケットで追記してください。個人メモでも「日付・用途・入力の要点・出力の使い道」を1セットで残すと検索性が上がり、異動時の引き継ぎもスムーズです。ステークホルダー別の典型的な懸念(経営はROI、情シスは漏洩、現場は手間と心理的負担)を箇条書きで持っておくと、同じ学びを説明する場面でも言い換え疲れが減ります。公開可否が曖昧な資料はそもそもAIに入力しない、と自分で宣言しておく線引きメモがあると、日々の判断が速くなります。
なお学習効率を上げるには、「読む→15分で演習→翌週に同じ手順でもう一度」をカレンダーに3連続で置き、忘却曲線を意識するのがコツです。複数人で進めるときは教え合うペアと日時を先に仮押さえし、片方が欠席しても演習PDFだけで進められるようにリンク集を1枚添えておくと属人化が進みにくくなります。最後に、成果が出た週は短いログ(良かった依頼1行)を残し、出なかった週は「阻害要因」を1語だけメモして次週の設計に回すと改善が続きます。
まとめ:次に何をするか
明日から1週間、「コミットは1日最大3つまで」ルールでAI改修を試し、diffの読みやすさを比較してください。
ツール情報(公式リンク)
権利表記・引用について
Cursorは各社の商標または登録商標です。本記事は各社の公式提供ではなく、一般的な情報提供を目的としています。機能や提供条件は変更される場合があるため、最新情報は公式ページをご確認ください。
画像クレジット
サムネイル/本文画像はUnsplashの写真を使用しています(ライセンス:Unsplash License)。
お問い合わせ
AIツールの導入・活用支援のご相談はお気軽にどうぞ
📞 090-6262-3842