この記事は「第2回 Cursor 入門 — 常駐する秘書と安全な頼み方 (Part 1)」の続きです
(続き:指示書と記録から)
6. 指示書と記録 — 秘書を迷わせない残し方
§5で一度成功したあと、「同じ成功を次も再現する仕組み」として申し送りを置きます。長く使うほど、場当たりのフォルダより、体系的で一貫した構造の方が効きます。
6-1. 長く使えるフォルダ構造をつくる
ここでは、長く使うときのフォルダの分け方の一例を示します(この型が唯一の正解ではありません)。
- 研究・教育・事務など、用途ごとの親フォルダを少数に決め、その名前と役割はあとから変えない(下の
Research/Edu/Adminなど)
- その下のプロジェクトは、日付+名前で新設する(並べると時系列が分かる)
- 新設したら、親の
AGENTS.mdに地図を追記する(秘書が古い地図のまま動かないようにする)
講義用の見本(この一例を図にしたもの。講師の実運用に近い形):
CursorWorkspace/ ← ルート。全体の安全策を書いた AGENTS.md
Research/ ← 研究
Edu/ ← 教育・教材
Admin/ ← 事務・運営
Personal/ ← 私用(必要な人だけ)
2026-session01/ ← 今日の講義用練習(仮置きで、あとで削除しても可)
プロジェクトを増やすときは、例えば Research の下に次のように頼む(日付は当日のものに置き換える):
Research の下に 2026-11-05-literature-review フォルダを作ってください。
Research の AGENTS.md に、そのフォルダの説明を追記してください。
ルートや他領域のファイルは触らないでください。
名前(Research / Edu / Admin / Personal)は一例です。自分の生活に合う少数の領域名に置き換えて構いません。大切なのは、長く同じ型を守ることです。講師が実際に使っている、もう一段大きな地図は 付録F。
6-2. AGENTS.md(や CLAUDE.md など)— 作り方
原則:中身は AI に作らせる(人間がゼロから書かない)
AGENTS.md は、人間が長文を手書きするファイルではなく、AI に草稿を作らせて、人間が読んで直すファイルだと考えるのが原則です。読者の主が AI なので、AI に書かせた方が形式も続きやすく、フォルダを増やしたあとの追記も頼みやすいです。
人間の役割は次です。
- 何を守らせたいかを短く指示する(消さない、このフォルダの外は書かない、など)
- できあがった
AGENTS.mdを自分の目で読む(約束6)
- おかしいところだけ直すか、直すよう頼み直す
見本(下)は、頼むときの材料・教室でのたたき台であり、「全部を自分で清書する」ことが本線ではありません。道具によっては /init で指示書のたたき台を出させる道もあります(付録D・E。今日の本線は、上のチャット依頼で AGENTS.md を作らせることです)。
何のためのファイルか
- 主な読者は AI(人間は内容確認のために読む)
- そのフォルダで守ってほしいルールを、チャットのたびに言い直さなくて済むよう残す
- 英語で書かれていることが多い(ツール側の習慣)。中身の役割さえ分かればよい。教室では日本語でも構わない
- いちばん大切な一文: AI が書いてよい場所/書いてはいけない場所、および消さないことを明示する(§3の第2防衛線)
CLAUDE.md など別名の指示書を使う道具もあります。今日の本線は Cursor 向けの AGENTS.md です。
名前は固定(一意性の例外)
ファイル名は AGENTS.md にそろえます(大文字小文字もこの形に揃えてください)。
第1回の「名前の一意性」では、README.md と同様、決まった名前で置く約束のファイルとして例外になります。別名(例:agents-rules.md)にすると、Cursor が自動では拾いにくいです。
どこに置くか — §6-5 とセットで考える
AGENTS.md は「書いた場所」だけでなく、あとでどのフォルダを Open Folder するかで、自動で届くかが決まります。
| 置く場所 | 向いている内容 | 自動で効きやすい開き方 |
|---|---|---|
ルート(CursorWorkspace/AGENTS.md) |
全体の安全策、領域一覧、共通の禁止 | CursorWorkspace/ を開いたとき |
領域(例:Research/AGENTS.md) |
その領域の地図・命名 | Research/(またはそれより上で、この領域を含む開き方) |
プロジェクト(例:2026-11-05-literature-review/AGENTS.md) |
その案件だけの注意 | そのプロジェクトフォルダを開いたとき(または親を開いてその中を触るとき) |
実務の決め方:
- 自分がよく Open Folder する階層を思い浮かべる(§6-5)。
- その階層を開いたときに必ず守ってほしい安全策は、その階層の
AGENTS.mdにも入るよう AI に書かせる(上の階層だけに書いて安心しない)。
- ルートに長い安全策がある場合でも、プロジェクトだけをよく開く人は、「このフォルダの外は書かない/消さない」など数行をプロジェクト側の
AGENTS.mdにも入れるよう頼むと欠落しにくいです。全部を複製する必要はありません。
- 領域やルートの地図・共通方針は、それぞれの階層に置き、狭く開く日は
@で親のAGENTS.mdを渡す、でもよいです(§6-5)。
- (応用)いま開いているフォルダの
AGENTS.mdに、「作業の前に、上の階層のAGENTS.mdを読め」と具体的に入れるよう AI に書かせる方法もある(下の「親を読ませる書き方」と §6-5)。自動では届かない親を、エージェントに読ませるための指示です。
作る手順(今日の最小)— AI に作らせ、自分で読む
- 置きたいフォルダを決める(教室なら、まず
CursorWorkspace/か、今日の練習用フォルダのどちらか1つでよい)。そのフォルダを Open Folder する(§6-5)。
- チャットで、短く具体的に頼む。例:
このフォルダに AGENTS.md を新規作成してください。
読者は AI です。先に Safety を短く書いてください。必ず入れること:
- このフォルダ(または CursorWorkspace)の外には書かない
- ファイルやフォルダを削除しない。移す提案だけして私の yes を待つ
- 論文用の Dropbox / OneDrive を作業ルートにしない
好みの文体は後回しでよいです。ほかのファイルは触らないでください。
終わったら、書いた内容の要約だけ報告してください。
- 確認ダイアログが出たら読む(約束2)。
- できた
AGENTS.mdを自分の目で読む。足りない禁止や、広すぎる許可があれば直すか、直しを頼む。
- 確認: いま Open Folder している位置で、その
AGENTS.mdが自動で届くか? 届かない位置にだけ置いたなら、開き直すか、要点をよく開く階層にも作らせる(§6-5)。
教室では、下の見本を @ で渡して「これに近い短さで、このフォルダ用に書いて」と頼んでもよいです。長く完璧な一式を一発で書かせることより、安全の数行が入っているかを自分で確かめることが本線です。
ルート見本 — 頼むときの材料(まず安全策)
AI に作らせるとき・直させるときの材料です。ルート(または、よく開くフォルダ)では、好みの文体よりファイル破損や誤操作を防ぐ安全策を先に入れます。
# AGENTS.md — CursorWorkspace(root)
## Safety (do these first)
- Write and edit only inside this CursorWorkspace tree unless I explicitly name another path.
- Never delete files or folders. If something should go, propose a move to an Archive folder and wait for my yes.
- Do not install packages, create virtual environments, or run bulk conversions inside this workspace. Ask first; use a sandbox outside synced folders if tooling is needed.
- Do not open or treat Dropbox / OneDrive areas as the working root.
- Before creating a new project folder under Research / Edu / Admin / Personal, use the name pattern YYYY-MM-DD-descriptive-name and update that area's AGENTS.md map.
- Prefer Markdown (.md) for new drafts unless I ask for another format.
プロジェクトだけを開くことが多い人向けの、さらに短い例(このフォルダ用):
# AGENTS.md — this project folder
## Safety
- Edit only inside this folder unless I name another path.
- Do not delete files or folders. Propose a move and wait for my yes.
- Do not touch files outside this folder.
親の AGENTS.md を読ませる書き方(狭く開くとき)
Open Folder したフォルダがワークスペースのルートになるため、その一つ上・さらに上の AGENTS.md は自動では入りません(§6-5)。代わりに、いま開いているフォルダの AGENTS.md(=その日のルートの指示書)の先頭に、「先に親を読め」と書いておく方法があります。
例(パスは自分の実パスに置き換える):
# AGENTS.md — this project folder
## Before any other work
1. Read these parent instruction files first (they are outside this Open Folder root, so they are not loaded automatically):
- ../AGENTS.md
- ../../AGENTS.md
2. Follow their Safety rules unless I explicitly override them in this file.
3. If a file cannot be read, stop and tell me.
## Safety
- Edit only inside this folder unless I name another path.
- Do not delete files or folders. Propose a move and wait for my yes.
注意:
- これは Cursor の「親子の自動結合」ではなく、エージェントへの作業手順の指示です。守られないこともあるので、いちばん重要な禁止(消さない・外に書かない)は、このファイル本体にも短く残してください。
- パスは 具体的に書く(
../AGENTS.mdや、分かるならフルパス)。「上の方の AGENTS」だけだと迷いやすいです。
- フォルダの外を読むため、Read Access や確認ダイアログが出ることがあります。内容を読んでから許可する(§1-2・約束2)。
- 親の全文を毎回コピーするより軽い一方、親を開く・要点を子に写す・
@で渡すより手順依存です。教室では、安全の数行を子にも書く方法を先に習い、この「読ませる書き方」は余裕があればで十分です。
好み・方針は「項目+典型例」だけ(余裕があれば足す)
安全策のあとに、自分がこだわる点を網羅的な長文ではなく、見出し+1〜2行で足します。以下は例です。
## Preferences (examples — pick only what you need)
### チャットの言語
既定は日本語。英語原稿の作業中だけ英語で返す。
### 文体
です・ます調。論文の英語は plain academic English。
### ファイル名
新規ファイルは YYYY-MMDD-HHMM-… 。フォルダは YYYY-MM-DD-… 。
### 引用
出典を捏造しない。無いなら「要確認」と書く。
### 変換(.md → Word / PPT)
指定フォント・サンドボックス・上書き禁止を守る(一度ここに書いておけば、依頼は短くてよい。詳細は §7-4)。
教室では、好みブロックから見出しを2つだけ選ぶか、安全策だけで止めても十分です。
6-3. README.md
- 読者は人間(未来の自分)
- このフォルダは何か、どこから読むか、注意事項を短く書く
6-4. 下層にも置いてよい/親子でどう書くか
AGENTS.md と README.md は、ルートだけでなく領域・プロジェクトにも置けます(置き場所の表と作り方は §6-2)。
同じツリーを Open Folder しているとき(親も子もその中にあるとき)の書き分けの目安:
- 親 … 安全枠・共通の禁止・広い地図
- 子 … 足す・具体化する(共著者、提出形式、その案件だけの例外)
- 親と子が食い違うときは、運用では「親の安全枠を壊さない」方向で読むと分かりやすいです(製品や設定で差はあります)
親を開いていない日の扱いは、次の §6-5 です。
6-5. 仕事を始めるとき、どの階層を Open Folder するか
Open Folder したフォルダが、その日のワークスペースの一番上(ルート)になります。
Cursor が自動でつなぐ AGENTS.md は、そのルート自身と、その下の子フォルダまでです。ルートより上にある AGENTS.md は、自動では読まれません。
例:…/Research/2026-11-05-literature-review/ だけを開くと、そのプロジェクト内の AGENTS.md は効きやすい一方、上の Research/AGENTS.md や CursorWorkspace/AGENTS.md は開いていないので、自動では届きません。
原則:今日使うファイルが入る範囲ではできるだけ狭く開く。ただし、今日効かせたい AGENTS.md がその外側にあるなら、開く位置を上げるか、下で述べる別手段を使う。
| 今日やりたいこと | 開く例 | 自動で効きやすい AGENTS |
|---|---|---|
| 1つのプロジェクトだけ。その案件用の指示で足りる | そのプロジェクトフォルダ | そのフォルダの AGENTS.md(あれば) |
| 同じ領域の複数プロジェクト/領域の共通ルールも効かせたい | 領域フォルダ(例:Research/) |
領域の AGENTS.md +その下 |
全体の安全策やルートの地図も効かせたい/ルートの AGENTS.md を直す |
CursorWorkspace/ |
ルートの AGENTS.md +その下 |
| やってはいけない例 | 「ドキュメント」全体、デスクトップ、クラウドの論文ルート | — |
狭さと指示の届き方を両立するとき:
- 上の安全策も今日使いたいが、ルートまでは開きたくない → 次のいずれか(併用可)。
- 重要な安全文を、いま開いているフォルダの
AGENTS.mdにも短く書く(いちばん欠落しにくい)。
- チャットで親の
AGENTS.mdを@で渡すか、「このパスのAGENTS.mdを読んでから作業して」と頼む。
- いま開いているフォルダの
AGENTS.mdの先頭に、「先に../AGENTS.md(など)を読め」と具体的に書いておく(§6-2「親のAGENTS.mdを読ませる書き方」)。自動読み込みではないが、毎回チャットで言い直さなくてよい。確認ダイアログが出たら読む。
- 重要な安全文を、いま開いているフォルダの
- 狭く開きすぎて必要なファイルが外に出る → 一度閉じ、一つ上を開き直す。
- 広く開きすぎる → 誤って触る範囲が広がる。
6-6. _WorkLog.md
- 思考や作業の走り書きを残すファイル。
- 長い期間にわたって作業をする時にこれがあると、AIも人間も作業経緯がわかって便利。これも積極的にAIに書かせると作業が楽になる。
- また、画面右の小さなチャット欄と違って、このファイルは画面中央に縦長く表記されるので、長い指示を書くときの下書きなどにも便利。
- 先頭
_は「自分用・一覧で区別しやすい」印(第1回)
- 追記向き。あとから過去の行を消してきれいにしすぎない方が、履歴になる
- プロジェクトごと、または領域ごとに置ける
6-7. タイムスタンプの指示を、どの AGENTS.md に入れるか
第1回の命名とつなぎます。新規ファイル名に日付や時刻を付ける型(例:YYYY-MMDD-HHMM-…)は、チャットでその都度言ってもよいですが、AGENTS.md に書いておけば繰り返しません。「その規則を、どの広さの仕事に効かせたいか」で、入れるファイルを選びます。
| こんなときに効かせたい | 入れる場所(AI に書かせてよい) | 例 |
|---|---|---|
CursorWorkspace 全体で同じ型にしたい |
ルートの AGENTS.md |
新規 .md はどれも YYYY-MMDD-HHMM-名前.md |
Research など、ある用途フォルダの中だけ別ルールにしたい |
その用途フォルダの AGENTS.md |
Research 内のメモは日付だけ(YYYY-MM-DD-名前.md)でよい、など |
| いまの案件フォルダだけ特別にしたい | そのプロジェクトフォルダの AGENTS.md |
共有用だけ日付なしの固定名、など |
受け継がれ方の注意(§6-5 と同趣旨): 上の表の「親」に書いた規則が自動で効くのは、その親フォルダをいま Open Folder に含めているときです。プロジェクトフォルダだけを開いていると、外側のルート/Research の AGENTS.md は自動では届きません。その日だけ親の命名規則も使いたいときは、開く位置を上げるか、@ で親の AGENTS.md を渡すか、要点をプロジェクト側の AGENTS.md にも短く入れてもらってください。子側に書くのは、主に「親と違う例外」か「この案件だけの追加」にすると迷いにくいです。
頼む例(ファイル作成)
今の時刻を使って、読書メモ用の .md を1つ作ってください。
ファイル名は YYYY-MMDD-HHMM-reading-notes.md の形にしてください。
このフォルダの外は触らないでください。
実習チェック(§6)
- ☐ 自分の領域分け(例:Research / Edu / Admin)を一文で言える
- ☐ 「Open Folder したフォルダより上の
AGENTS.mdは自動では読まれない」と説明できる
- ☐
README.mdか_WorkLog.mdの片方(できれば両方)を置き始めた
- ☐ (余裕)よく開く階層に短い
AGENTS.mdを AI に作らせ、安全策が入っているか自分で読んだ(上だけに頼っていない)
7. 2回目の練習と、入力のコツ
7-1. @ でもう少し(今日覚えておく範囲)
入力窓で @ を押すと候補が出ます。メニュー項目は版で増減するので、候補を見るのが本線です。
| 入力 | 用途(学生向け) |
|---|---|
@+ファイル名/フォルダ名 |
「これについて」と明示して渡す。フォルダ選択後に / で下層へ進めることもある |
`(バッククォート) |
ファイル名・短語を正確に囲む |
関連ファイルが分かっているときは @ で渡す。分からないときは @ なしでもエージェントが探すことがあります。探させたいときは §3-4 の「パスだけ/書かないで」型が安全です。
7-2. ウェブで調べてほしいとき
- 「調査をしてください」だけでは、ローカルや手元の知識だけで終わることもあります。
- ネットが必要なら、日本語で 「ウェブで調べて」「公式サイトの情報を確認して」 と明示してください。
- 動かないときは、設定の Web Search(名称は版による)がオンか、確認ダイアログで拒否していないかを見ます。
教室での言い分け:
| 頼み方 | ねらい |
|---|---|
| 「フォルダの中を探して、パスだけ」 | ローカルの読み取り |
| 「ウェブで調べて」 | ネット上の最新・公式情報 |
7-3. 2回目の実践(模様替えか、申し送りの追記)
講師の合図で、次のどちらか1つだけ行います。
A. 模様替え(約束4)
2026-session01 の中に notes フォルダを1つ作り、指定する .md を1つそこへ移してください。
このフォルダの外は触らないでください。
B. 申し送りの追記
_WorkLog.md に、今日やったことを3行以内で追記してください。
既存の行は消さないでください。
7-4. Markdown から Word / PowerPoint へ(必須)
下書きは .md のまま残し、提出や配布用に Word(.docx)や PowerPoint(.pptx)へ変換します。今日の本線の一部です(教室では講師の合図で1回はやる)。
設定・環境の原則(詳細手順は AI に尋ねる)
変換の道具(Pandoc など)や置き場所は、パソコンごとに差が出ます。次の原則だけ先に固定し、具体的なクリック手順やインストール手順はその場の AI に尋ねてください(画面が違うときはスクリーンショットを添付。手順は古くなりうる、という冒頭のメッセージと同じです)。
- 同期中の
CursorWorkspaceの中で、変換用の環境構築や大量の中間ファイル書き込みをしない(破損・競合の元)。変換やインストールの作業は、下の変換用サンドボックスで行う。
- 完成した
.docx/.pptxだけを、自分のAI作業フォルダへ戻す(または最初から出力先を指定する)。
- 変換後の Word / PPT を手で直したあと、同じ出力ファイルへ安易に再変換して上書きしない(直した体裁が消える)。
- 分からなければ、スクショを添えて AI に「今の Windows / Cursor 環境で、安全に
.mdを Word にする手順を順に教えて」と頼む。
変換用サンドボックス — どこに置くか・どう名付けるか
ここでのサンドボックスは、§1-2 の製品機能ではなく、Pandoc や一時ファイル、インストール残骸などを置くためのローカル作業フォルダです。論文用クラウドや CursorWorkspace の同期を壊さないための囲い、と考えてください。
置き場所(一般的な注意)
- Dropbox / OneDrive など同期中の論文置き場の中に作らない
CursorWorkspace(AI作業フォルダ)の中にも作らない
- パソコン本体の、クラウド同期していない場所に置く。Windows の一例:
C:\Users\あなたの名前\AISandbox\(フォルダ名はAISandboxなど分かりやすい固定名でよい。教室では講師がパスを示すこともある)
- Mac でも同様に、iCloud で同期している「デスクトップ/書類」の直下は避け、同期しないローカルの場所を選ぶ
命名(一般的な注意)
- 親フォルダ(例:
AISandbox)は、毎回使う置き場の名前として固定してよい(AGENTS.mdと同様、決まった名前の例外に近い)
- その中の案件ごとのサブフォルダは、ほかとぶつからない固有名にする(第1回の名前の一意性)。例:
2026-11-05-session01-md-to-docx(日付+内容。フォルダは日までの型が分かりやすい)
- 中間ファイルの名前も、完成物と取り違えないよう、固有名・日付付きを心がける
運用
- 変換やツールの作業はサンドボックスで行い、完成した提出用ファイルだけを AI作業フォルダへコピーして戻す
- サンドボックス全体を Cursor の Open Folder にしない方が安全なことが多い(中間ファイルが多く、触る範囲が広がりやすい)。どうしても開くなら、その案件のサブフォルダだけに狭くする(§6-5)
- 詳細なクリック手順は、自分の OS に合わせてその場の AI に尋ねてよい
フォントなどは必ず指定する
指定しないと、環境既定のフォントになり、提出物の見た目が安定しません。依頼文に必ず書き入れてください(大学や研究室の指定があればそれに合わせる)。
| 出力 | 必ず書くことの例 |
|---|---|
Word(.docx) |
本文フォント(例:日本語は游明朝または指定の明朝、英数字は Times New Roman または指定)、本文サイズ(例:10.5 pt)、見出しフォントとサイズ(例:游ゴシック。見出し1=14 pt、見出し2=12 pt、見出し3=10.5 pt)、余白の指定があればそれも |
PowerPoint(.pptx) |
タイトル/本文のフォントとサイズ、1枚あたりの目安行数、テーマ色を触ってよいか否か |
頼む例(Word)— 初めて・ルールがまだ無いとき
@practice-session01.md を Word(.docx)に変換してください。
本文の日本語フォントは游明朝、英数字は Times New Roman、本文は 10.5 pt にしてください。
見出しは游ゴシックで、見出し1は 14 pt、見出し2は 12 pt、見出し3は 10.5 pt にしてください。
変換用の作業は講師が示した場所で行い、完成した .docx だけこのフォルダに置いてください。
元の .md は残し、削除しないでください。
教室でフォント指定が別紙にある場合は、その指定を優先します。
毎回細かく書かなくてよい — 一度定義して使う
フォントや余白、サンドボックスの使い方を、依頼のたびに全部打ち直す必要はありません。 よく使う指定は、どこか一か所に書いておき、以後は「それに従って」と短く頼む方が楽です。置き場所の候補は次です。
| 置き場所 | 向いていること | 効き方の目安 |
|---|---|---|
AGENTS.md(ルートやよく開くフォルダ。§6-2) |
毎回守りたい変換の既定(フォント・サイズ・サンドボックス・完成物だけ戻す、など) | そのフォルダを Open Folder していると自動で届きやすい |
Agent Skill(Cursor のスキル。例:.cursor/skills/md-to-docx/SKILL.md) |
「.md → Word」など、手順付きの作業をまとめた取扱説明 |
エージェントがスキルとして参照する(作り方の細部は AI に「Cursor の Agent Skill の作り方を教えて」と尋ねてよい) |
短い手順メモ(例:Recipes や自分用の .md) |
大学指定の体裁表をそのまま残したいとき | 依頼時に @ でそのファイルを渡す |
AGENTS.md に書く例(Preferences の一部。§6-2 の見本と同趣旨):
### 変換(.md → Word / PPT)
- Word:本文は游明朝+ Times New Roman、10.5 pt。見出しは游ゴシック(見出し1=14 pt、見出し2=12 pt、見出し3=10.5 pt)。
- 変換作業は AISandbox(同期外)で行い、完成した .docx / .pptx だけこのワークスペースへ戻す。
- 手修正した提出ファイルを、同じ名前で安易に再変換して上書きしない。
こうした定義を置いたあとの短い依頼例:
@practice-session01.md を Word に変換してください。
フォント・サンドボックス・上書き禁止は AGENTS.md の変換ルールに従ってください。
元の .md は残してください。
Skill を使う場合も同様で、「md-to-docx のスキルに従って変換して」と頼むか、スキル側の説明に「いつ使うか」を書いておけば、毎回の長文指定を減らせます。
今日の教室では、まず依頼文に一度書いて成功させ、余裕があれば同じ内容を AGENTS.md に移す、で十分です。Skill は「何度も同じ変換をするようになってから」で構いません。
日本語入力でメッセージが送れない・半角に切り替えたい、など環境のコツは 付録C(送信は §1-6 の Ctrl+Enter)。
実習チェック(§7)
- ☐ 2回目の依頼を1つ完了した
- ☐ 「ウェブで調べて」と「フォルダの中を探して」の違いを説明できる
- ☐
.md→ Word または PowerPoint を、フォント指定つきで1回試した(または手順を AI に確認した)
8. 本日のまとめと宿題
まとめ(両回を貫く糸の回収)
- 論文クラウド ≠ AI の作業場(ローカルの狭いフォルダだけ開く=第1防衛線)
- Markdown は下書きの共通語(提出形は Word/PPT へ。フォントは指定する)
- 名前と場所を自分で決める(領域+
YYYY-MM-DD-…。通奏はpractice-session01.md)
- 読みと書きは別。書いてよい場所は
AGENTS.md等で縛る(第2防衛線。AGENTS.mdは AI に作らせて自分で読む。安全策が先)
- 消す判断は渡さない/模様替えは頼む/確認は読んでから(自動補完はオフ、送信は
Ctrl+Enter)
- 大きな依頼の前は Plan モードを検討(計画を見てから進める。Agent は小さく具体的な依頼向き。§1-4)
- わからない操作は AI に聞く(画面の画像を添付して具体的に。講師にも聞いてよい)
- 操作手順はこの紙より速く古くなる(約束は残る。クリック位置は、その時点の画面で確認し直す)
就職後の教材づくりや事務文書でも、同じ型が使えます。
宿題
自分のローカルAI作業フォルダに、次を置いてみてください(中身は数行で可)。practice-session01.md は消さないでください。
README.md… このフォルダは何か、を人間向けに短く
_WorkLog.md… 今日やったこと、次にやりたいことを追記
余裕があれば、ルートまたは領域用のごく短い AGENTS.md も1つ AI に作らせる(安全策を先に。「このツリーの中だけ書く/削除しない」を必ず入れるよう指示する。できた文を自分で読む。好みは項目+典型例だけでよい)。
作成したマークダウンがあれば、講師の指示に従って提出してください。
9. 便利さの先にある危険 — 自分の頭を使わなくなること
ここまで読んでくださった方へ、最後に一つだけ、ファイルの破損や削除とは別の危険を書きます。
Cursor などのエージェント型 AI は、使い方を誤ると(というより、うまく使いすぎると)、ほとんど自分の頭を使わずに、論文の体裁まで整った文章を量産できてしまいます。章立てを聞き、文献らしい文を足し、反論らしき段落を足し、要約を足す——その繰り返しで、「書けたように見える原稿」が手元に残ります。提出物としては通ってしまうことさえあるかもしれません。
しかし長期的に見れば、それは明らかに危険です。研究でも教材づくりでも、あとから効いてくるのは、自分で問いを立て、文献を読み、筋の通らない箇所に自分で気づき、言葉を選び直す力です。その練習を秘書に丸投げし続けると、提出は速くなっても、考える筋肉が育たないまま進みます。一度失った習慣は、便利な道具があるほど取り戻しにくいです。
今日の配布が「安全な頼み方」を長く書いているのは、ファイルを守るためだけではありません。判断と主張は自分の側に残すための練習でもあります。AI に頼んでよいのは、手順のはっきりした作業や、自分がすでに考えた内容の整形・移動・変換などです。「何を主張するか」「なぜそう言えるか」まで委ねないでください。
便利さは本物です。だからこそ、使うほど、自分の頭で考える時間を意図的に残す必要があります。
付録A. よくあるつまずき
| 症状 | まず疑うこと |
|---|---|
| AI が別のファイルを触る | 開いているフォルダが広すぎないか/@ で対象を指定したか/AGENTS.md に範囲を書いたか |
| 確認が出て進まない | 拒否して言い直す。内容を読まずに許可しない |
| 「調査して」なのにネットを見ない | 「ウェブで調べて」と明示する。設定の Web Search を確認する |
| ネットはあるのに AI が黙る | サインイン、モデル選択、サービス側の障害 |
チャット型だけに頼む場合との違い(一言):コピー往復が減る代わりに、開くフォルダと削除の依頼と書き込み範囲に注意が要る。
付録B. 他の道具の名前と、Cursor と VS Code+拡張の比較(
本線は Cursor だけです。あとで選び直すときのための地図です。
B-1. 名前の整理
| 種類 | 大ざっぱな位置づけ | 今日 |
|---|---|---|
| VS Code | 高機能なエディタ。拡張でいろいろ足せる | 第1回で使用 |
| Cursor | VS Code 系+エージェント型 AI が最初から組み込み | 今日使う |
| Claude Code | Anthropic 側のエージェント。ターミナルや開発寄りも含めて動かす色が強い。VS Code の拡張機能としても使える | 紹介のみ |
| Codex | OpenAI 側のエージェント/コーディング支援。こちらも VS Code の拡張機能として足せる文脈が多い | 紹介のみ |
| Zed など | 別系統のエディタ。AI の付け方は製品ごと | 本日は深入りしない |
拡張機能とは、本体ソフトに後から足す部品のことです。第1回の VS Code に「Claude Code」や「Codex」を入れると、見た目はいつもの VS Code のまま、横や別パネルでエージェント型 AI に頼めるようになります。
| 入り口 | 例 | 向きやすいとき |
|---|---|---|
| AI 付き IDE(エディタ一体型) | Cursor/拡張を入れた VS Code | 下書きを見ながらその場で直す(今日の本線) |
| デスクトップ版(専用アプリ) | Claude / Codex などの別アプリ | 長時間・並列など、必要になってから |
同じAI作業フォルダを、IDE とデスクトップの両方で同時に開いて AI に触らせない(第1回の「AI作業フォルダを分ける/同時に触らせない」と同じ理由)。
B-2. Cursor と「VS Code + Claude Code または Codex」の比較
どちらも「フォルダを開き、.md を見ながらエージェントに頼む」という点では仲間です。違いは、AI が最初から付いているか/あとから足すか、および誰のサービスを主戦場にするかに近いです。
| Cursor | VS Code + Claude Code または Codex(拡張) | |
|---|---|---|
| たとえ | AI 付きの机が最初からセット | いつもの机に、好きな秘書キットを後付け |
| 入りやすさ(文書用途) | 画面・チャット・フォルダが一続きで分かりやすいことが多い | 第1回の VS Code 操作はそのまま使える。拡張の入れ方・サインインが一段増える |
| 長所 | エージェント前提の画面と設定がまとまっている。非エンジニアの「まず1本」に説明しやすい | エディタ本体は無償の VS Code のまま。Claude Code は Claude の有料プラン(Pro 等)でサインインできる(Anthropic 公式)。Codex 拡張は ChatGPT プランで使える(OpenAI 公式)。すでにその契約がある人は、Cursor 用の契約を足さずに始められる場合がある。拡張を外したり替えたりしやすい |
| 短所 | Cursor 内蔵のエージェントの利用は、Cursor(現在は The X Subscription に含まれる場合あり)側の枠・課金が基本。Claude や ChatGPT の有料プランがあっても、その枠を Cursor 内蔵エージェントへそのまま流用はできない(公式:第三者モデルは別扱い/別課金)。無料枠はあるが限定的。VS Code 用の拡張がすべて同じように動くとは限らない | 製品ごとの画面・許可・記号(@ や /)が違い、最初の学習コストが散らかりやすい。設定やトラブルも「VS Code 側か/拡張側か」で切り分けが要る。Claude Code/Codex も、各社の利用上限やプラン条件の確認が要る |
| 向く人の例 | 今日のように、エージェント型を一本の道で覚えたい | すでに VS Code に慣れており、特定の会社の AI(Claude または OpenAI)を主に使いたい |
| 向かない/後回しの例 | すでに社内で VS Code+指定拡張が決まっている場合は、無理に移さなくてよい | 「まず秘書の安全な頼み方」だけ学びたい初日(今日の教室) |
どちらを選んでも変わらないこと(この講義の約束はそのまま効く)
- 開くフォルダは狭くする
- 消す判断は渡さない
AGENTS.mdなどで書いてよい場所を縛る
- 確認ダイアログは読んでから押す
- 同じフォルダを、別の AI 付き道具で同時に触らせない
今日の結論: 教室では Cursor だけ使う。あとで VS Code に Claude Code や Codex を足す道もある、と知っておけば十分です。入力記号の詳細は 付録D・E。
付録C. 困ったときの入力・キーボード
本線の説明は §1-6(Ctrl+Enter)と §1-5(自動補完オフ)です。詰まったらここを見返し、手順は AI に尋ねてください。Agent/Plan は §1-4。
Ctrl+Enter で送信(再掲)
Cursor、および VS Code+AI のチャット欄では、送信を Ctrl+Enter にすると日本語ユーザーの誤送信が減ります。
- 設定手順は環境差が大きいので、AI に尋ねる(例:「チャット送信を Ctrl+Enter にする方法を、今の画面の言葉で教えて」)
「半角/全角」キーと、無変換/変換キー(Windows)
キーボード左上付近の 半角/全角(表記は機種で「半角/全角」「漢字」など)は、Windows の日本語ユーザーがよく押すキーです。ただしこれは、いまの状態を入れ替える切替であり、「必ず半角にする」「必ず全角にする」という絶対指定のキーではありません。 いま半角なら全角へ、いま全角なら半角へ、と逆側に飛ぶだけなので、「半角にしたつもりが全角のまま/その逆」と混乱しやすいです。いまどちらにいるかは、タスクバーの IME 表示(「A」や「あ」など)で確認するのが確実です。
いま欲しい側へ直接寄せたいときは、切替ではなく、次のようなキーの方が分かりやすいことが多いです。
| キー | よくある割り付けの例 |
|---|---|
| 左の 無変換 | 半角英数へ切り替え(いまの状態に依存しにくい) |
| 右の 変換 | 全角ひらがなへ切り替え(いまの状態に依存しにくい) |
※ OS や IME の版・設定で違います。自分の環境で違う場合は、その場で AI か講師に確認してください。マークダウンの # や .md など、半角が必要な記号を打つ前は、半角英数になっているかを一度確認する癖が安全です。
付録D. Claude Code — @ とスラッシュ(余力)
今日は使いません。将来、別ツールを触るときの地図です。
出典の例:Claude Code Docs(Interactive mode / Commands)。コマンドはプラン・版で出揃いが異なります。/ はメッセージ先頭でのみコマンドとして認識されます。
| 入力 | 意味 |
|---|---|
@ |
ファイル/ディレクトリのパス補完 |
/(先頭) |
コマンド/スキル一覧 |
!(先頭) |
シェルモード(実行結果を会話へ) |
?(空の入力) |
ショートカットヘルプ |
| コマンド例 | 一言 |
|---|---|
/init |
指示ファイル(CLAUDE.md など)のたたき台 |
/permissions |
何を自動承認するか |
/model・/effort |
モデルや思考の重さ |
/plan |
大きな変更の前の計画モード |
/compact |
長い会話の要約 |
/clear(/new) |
新しい会話 |
/diff |
いま変わったファイルの確認 |
/add-dir |
別ディレクトリをセッションに足す(範囲が広がる=注意) |
/deep-research |
ウェブ横断の調査(必要時のみ) |
/help・/config |
ヘルプ/設定 |
/ を押すと候補が出ます。全部覚える必要はありません。
付録E. Codex — @ とスラッシュ(余力)
今日は使いません。ChatGPT ウェブ版の / メニューとは別物です。
出典の例:OpenAI Developer commands / Prompting。
| 入力 | 意味 |
|---|---|
@ |
ワークスペース内のファイルを検索し、パスを入れる |
/mention |
ファイル言及を対話的に挿入 |
/ |
スラッシュコマンドのポップアップ |
!(行頭) |
ローカルシェル(承認・サンドボックス設定の下で) |
| コマンド例 | 一言 |
|---|---|
/init |
AGENTS.md のたたき台 |
/model |
モデル切替 |
/permissions |
承認なしでできることの調整 |
/approve |
拒まれた操作の再承認(必要なとき) |
/plan |
計画モード |
/compact |
文脈の圧縮 |
/status |
セッション情報 |
/review |
変更のレビュー |
/exit・/quit |
終了 |
IDE 拡張では開いているファイルが文脈に入りやすいです。CLI では @ や /mention でパスを明示します。
付録F. 講師が使っている作業場の一例(AIWorkspace)
これは講師のパソコン上の実例です。あなたが今日作る ドキュメント\CursorWorkspace より大きな地図です。あくまで参考です。真似する必要はありません。「道具ごとに部屋を分け、共通のルール置き場と受け渡し置き場がある」ことだけ見取ってください。
F-0. 講師の AI 付き IDE の使い分け(参考)
講師は、AI 付きの IDE を次の3つに分けています。ねらいは、用途ごとに別の AI(モデル)を同時進行で動かすことです。同じフォルダを複数の道具で同時に触らせない、という約束(付録B)の、講師側の実例でもあります。
| AI 付き IDE | 講師の主な使いどころ |
|---|---|
| Claude Code(VS Code の拡張として) | 研究、および複数の AI モデル/道具をまたぐ作業の統括 |
| Codex(エディタ Zed 上で) | Claude の補佐(Deep Research や Second Review など)、および画像生成まわり |
| Cursor | 教育と行政・事務 |
今日の教室は Cursor 一本です。上の表は「なぜ講師の地図に道具ごとの部屋があるか」を読むための注釈であり、受講者が3つを揃える手順ではありません。
パスのイメージ(Windows):
…\Dropbox\Yanase's documents\AIWorkspace\
F-1. いちばん上(ルート)の考え方
AIWorkspace/
├── AGENTS.md ← 全体の道しるべ(どの道具がどこで働くか)
├── _shared/ ← 共通ルール・文体など(全道具が同じ正本を読む場所)。各 AI は読むが、勝手に書き換えない。書き換えると道具ごとにルールがずれて「どれが正しいか」が壊れるため
├── _handoff/ ← 道具どうしの受け渡しトレイ
├── CursorWorkspace/ ← Cursor 専用の作業場
├── ClaudeWorkspace/ ← Claude(Claude Code など)専用
├── CodexWorkspace/ ← Codex 専用
└── (Archive…) ← 古い世代の保管。講義では触らない
| 名前 | 役割(平たい言い方) |
|---|---|
_shared/ |
共通の取扱説明書(正本)置き場。全道具が同じルールを読む。読むのは自由だが勝手に書き換えない(書き換えると道具ごとにルールがずれてしまう) |
_handoff/ |
荷物の受け渡し場(例:調べものの報告書、完成した画像) |
*Workspace/ |
その AI 道具だけが普段書き込む部屋。同時に同じ部屋を別道具で触らない |
F-2. _shared/ と _handoff/(中身の例)
_shared/
├── SafetyRules.md など ← 安全の正本(ファイル名は例)
├── StyleProfiles/ ← 文体のプロファイル
├── Recipes/ ← Word/スライド変換などの手順書
└── …
_handoff/
├── HandoffDeepResearch/ ← 調べものレポートの受け渡し
├── HandoffImages/ ← 完成画像の受け渡し
└── …
F-3. CursorWorkspace/(Cursor 側の部屋分けの例)
講師の Cursor 側は、用途ごとにサブフォルダを切っています(名前は英語が多いです)。§6 の Research / Edu / Admin と同じ発想で、長く使う領域名を先に固定する例だと思ってください。
CursorWorkspace/
├── AGENTS.md
├── CursorGeneral/ ← 全体の記憶・通達など
├── CursorEdu/ ← 教育・教材まわり
├── CursorAdmin/ ← 事務・運営まわり
├── CursorTech/ ← 道具や講義準備(本配布の原稿もここ系統)
├── CursorDeepResearch/ ← ウェブ調査プロジェクト
├── CursorPRWriting/ ← 公開用の文章下書き
├── CursorJpRewriting/ ← 日本語の書き換え
├── CursorImages/ ← 画像制作のAI作業フォルダ
├── CursorProjects/ ← どれにも入らない耐久プロジェクト
├── CursorTemporary/ ← セッションをまたぐ仮置き
├── CursorScratchpad/ ← その場限り
└── CursorArchive/ ← 捨てずに移す先(削除の代わり)
F-4. 他の道具側(同じく樹形図)
名前の付け方は道具ごとに少し違いますが、「用途で部屋を分ける/Temporary・Archive を持つ」発想は共通です。全部覚える必要はありません。
ClaudeWorkspace/
├── ClaudeGeneral/ ← 全体の通達・記憶など
├── ClaudeResearch/ ← 研究まわり
├── ClaudeTech/ ← 道具・技術まわりの準備
├── ClaudePersonal/ ← 私用
├── ClaudeTemporary/ ← 仮置き
├── ClaudeScratchpad/ ← その場限り
├── ClaudeArchive/ ← 捨てずに移す先
├── ClaudeCommands/ ← コマンド類(講師環境の細部)
├── ClaudeCorpora/ ← コーパス(文体などの材料)
├── _skills/ ← スキル定義
└── MySecondBrain/ ← 知識ベース(この環境では Claude 側に置いている例)
CodexWorkspace/
├── CodexGeneral/ ← 全体の通達など
├── CodexProjects/ ← 耐久プロジェクト
├── CodexDeepResearch/ ← ウェブ調査
├── CodexTech/ ← 道具・技術まわり
├── CodexPRWriting/ ← 公開用の文章下書き
├── CodexImages/ ← 画像まわり
├── CodexBrainstorming/ ← 発想・下書き
├── CodexSecondReview/ ← 他ツール成果の見直し
├── CodexTemporary/ ← 仮置き
├── CodexScratchpad/ ← その場限り
└── CodexArchive/ ← 捨てずに移す先
F-5. 受講者の地図との対応
| 講師の例 | 今日のあなた向けの縮小版 |
|---|---|
AIWorkspace の下に道具ごとの Workspace |
まず ドキュメント\CursorWorkspace ひとつでよい |
CursorEdu / CursorAdmin / … |
§6 の Research / Edu / Admin / Personal |
_shared / _handoff |
最初は不要。道具を複数使い始めたら「共通ルール」と「受け渡し」が欲しくなる |
CursorArchive |
「消さない。控えや Archive へ移す」という考え方だけ先に持つ |
フォルダ名や深さは人ごとに違って構いません。真似するなら、(1) クラウドの論文置き場と分ける (2) 領域を少数に固定する (3) プロジェクトは日付付きで増やす (4) 道具ごとに部屋を分けるの4点だけで十分です。