Cursor 研修カリキュラム — エンジニア向け半日プログラムの設計と運用ルール

1. 半日カリキュラムの構成

1 セッションあたり 4〜8 名が動きやすい人数です。社内研修としては、 午前に「コード以外の AI 活用」、午後にこの Cursor 半日を入れる 二段構成にすると、非エンジニア職と混合チームでも噛み合います。

2. Tab / Inline Edit の癖

Tab 補完は「文脈に同調しすぎる」性質があります。1 行で済む変数名 補完には強い一方、長めの diff を提案してきたときは Inline Edit (⌘K) に切り替えて範囲を指示するほうが速い。 受講者には次の判断軸を渡します。

• 「補完が 5 行以上のときは一旦止めて ⌘K で書き直す」
• 「import の追記補完は通す。ロジックの追記補完は読んでから通す」
• 「テストファイル上では補完を多めに信頼する。プロダクションコード上では厳しめに」

3. Composer — 多ファイル編集の主力

Composer (⌘I) は「指示 → diff プレビュー → Apply」の 一往復で多ファイルを編集できるモードです。研修では次の 3 パターン をハンズオンで踏みます。

1. 機能名で @Folder 指定して関連ファイルだけスコープ
2. @File で起点ファイル + @Code でシンボル単位の参照
3. Apply 前に diff を読み、修正したいときは「上の diff の N 番目だけ {...} に書き換えて」と再指示

Apply 後は git add -p を必ず通すルールを敷くと、AI に書かれた覚えのない変更を残したまま commit する事故が消えます。

4. Agent Mode — 自走させる境界

Agent Mode はファイル探索・ターミナル実行・自動修正までモデルが ループします。便利だが境界の設計を間違えると本番リポを荒らせる ため、研修では次の 4 つを必ず教えます。

• auto-run コマンドはホワイトリスト方式。rm, git push, migrate は外す
• 新規ブランチ前提: Agent Mode 起動前に必ず git checkout -b agent/xxx
• 長時間タスクは 1 回 30 分上限。途中で必ず Apply / Reject の判断を挟む
• 本番 .env は読ませない。.cursorignore で .env*, secrets/ を除外

5. Cursor Rules — チーム共通の書き方

研修の中心は「ルールを 1 枚書き上げて Apply まで体験する」工程です。 下記をひな型として配布し、各社の規約に置き換えていきます。

# .cursor/rules/team.mdc
---
description: チーム共通ルール (TypeScript / Next.js / pnpm)
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: true
---

# コーディング規約
- pnpm を使う。npm / yarn コマンドは提案しない
- 新規ファイルは Server Component を既定にする。"use client" は必要時のみ
- as any 禁止。型が複雑なら unknown + narrowing
- console.log は提案しない。logger を使う

# 禁止
- src/server/ の Server-only API を src/app/ から直接 import しない
- 環境変数の値をログ出力しない (process.env.* を直接 console に渡さない)

• alwaysApply: true は team.mdc 1 枚だけにする (全部 always だと取り合いが起きる)
• 禁止事項は 原因と一緒に 書く (「なぜダメか」を書かないとモデルが守らない)
• 巨大なルールより 3〜5 個に分割。globs で自動選択させる

6. MCP の追加

// ~/.cursor/mcp.json (グローバル) または .cursor/mcp.json (リポ単位)
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp"],
      "env": { "LINEAR_API_KEY": "lin_api_xxx" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgres://..."]
    }
  }
}

研修ハンズオンでは Linear MCP を入れて「@Linear で自分のチケットを 引いてきて、関連ファイルに Composer で実装をあてる」流れを 1 周 回します。API キーを env に直書きするのは演習用のみで、 実運用では 1password run や OS のキーストア経由で渡す ことを徹底します。

7. レビュー体制と機微情報

1. PR は AI 生成かどうかを区別しない。レビュー基準は同じ。ただし生成元 (Cursor / Claude Code / Codex) は PR 本文に書く
2. テストが書かれていない PR は AI でも人でも同じくマージしない
3. Cursor の Privacy Mode を有効にする。エンタープライズ契約の場合はリポジトリ単位で確認
4. Privileged データ (社員情報 / 顧客 PII) は .cursorignore + Privacy Mode + 入力モデレーションの 3 層で守る
5. 退職者の発生時に Cursor のチームから即外す (キャッシュ越しに過去のコードに触れる可能性が残る)

8. Codex / Claude Code との役割分担

Cursor

エディタに居続けて 1 ファイル / 範囲が見えている編集に集中。レビュー前の最終形にする工程

Claude Code

ターミナルで複数チャットを並列。長時間タスクと探索的な調査・大規模リファクタ・PR テンプレートを使った定型作業

Codex

セカンドレビュー / 別実装でクロスチェック。Cursor で書いたものを Codex に審査させる「2 段レビュー」