第3章|仕事を進める環境を確かめる。
DAY 15 ・ 約15〜20分Visual Studio Codeとエージェント
コード、差分、診断、ターミナルを同じ作業場所で確かめながら進める。
VS Codeで正しい作業場所と文脈を示し、エージェントの変更を差分と実行結果で安全に検証できる。
言葉を知る
Visual Studio Code
ファイル編集、検索、診断、ターミナル、Git、拡張機能を一つの画面で扱えるコードエディター。
ワークスペース
VS Codeで一緒に開くフォルダーや設定の単位。エージェントが作業対象を理解する境界にもなる。
エディター文脈
開いているファイル、選択範囲、カーソル周辺、診断など、依頼と一緒にエージェントへ渡す情報。
差分
変更前と変更後を比較し、追加、削除、書き換えを示したもの。
統合ターミナル
VS Code内でコマンド、テスト、ビルドなどを実行できる画面。
拡張機能
ワークスペース設定や拡張機能はプロジェクトごとに動作を変える場合があります。
デバッグ
見慣れないプロジェクトを開く時は、信頼できる出所か、タスクやデバッグ設定が何を実行するかを確認します。
仕組みを理解する
VS Codeは会話と成果物を隣り合わせにする
通常のチャットAIへコードを貼ると、返ってくるのは説明やコード例です。利用者は正しいファイルを探し、回答を転記し、動くかを別の場所で確かめます。Visual Studio CodeにCodexやClaude Codeなどのエージェントを組み合わせると、会話の隣に実際のファイル、検索結果、診断、差分、ターミナルを置き、調査から変更、検証までを同じ作業場所でつなげられます。 便利さの中心は、AIがエディターの見た目を理解することではありません。対象ファイルや選択範囲を明示し、エージェントが行った変更を実ファイルと差分で確認し、コマンドの結果まで照合できることです。OpenAIのCodex IDE拡張には、選択した範囲やファイル全体を現在の会話へ加える操作があります。Claude CodeのVS Code連携でも、選択範囲や診断などのIDE文脈を利用できます。 エージェントはコードの説明、複数ファイルの編集、テストの実行、エラー調査を支援できます。一方、画面に見える要望だけから事業上の正解、公開可否、個人情報の扱いまで決められません。拡張機能を入れたことも品質保証にはなりません。人が正しい対象、制約、合格条件を示し、現実の証拠を読んで採用します。
最初に正しいワークスペースと現在地を確定する
VS Codeを開いたら、エージェントへ依頼する前にウィンドウのタイトル、Explorerの最上位、現在のパスを確認します。同名の正式版、復旧用コピー、練習用コピーがある場合、見た目だけでは区別できません。エージェントは開かれたワークスペースで忠実に作業するため、誤ったフォルダーを開けば、よくできた変更でも事故です。 次にSource Controlで現在のリポジトリ、ブランチ、変更一覧を確認します。既にある変更は他の仕事や利用者の作業かもしれません。依頼と無関係な差分を削除、整形、上書きしないよう明示します。複数のルートを一つのワークスペースへ開く機能は便利ですが、別案件を混ぜると参照や編集の境界が曖昧になります。必要なルートだけを開き、書き込み禁止の場所を言葉と権限の両方で区切ります。 ワークスペース設定や拡張機能はプロジェクトごとに動作を変える場合があります。見慣れないプロジェクトを開く時は、信頼できる出所か、タスクやデバッグ設定が何を実行するかを確認します。「このフォルダーが正本」「このブランチで作業」「既存差分は保持」「対象外へ書かない」という四点を開始時に確定すると、以後の説明と検証の基準ができます。
必要な文脈を選び、期待する動きを言葉にする
エディターを開いていても、エージェントが常に全ファイル、全タブ、画面上のすべてを正確に見ているとは限りません。Codex IDE拡張では、選択範囲やファイルを会話へ追加できます。自動のIDE文脈を利用する場合も、何を根拠にしてほしいかを依頼文で示します。対象の関数、エラーメッセージ、再現手順、関連するテスト、変更禁止範囲を一緒に渡します。 選択範囲は「この処理を説明して」「この関数だけ直して」のような狭い相談に向きます。しかし原因が別ファイルにある時、範囲を狭めすぎると表面的な修正になります。反対にリポジトリ全体を無条件に文脈へ入れると、関係ない情報が判断をぼかします。最初は症状と入口を示し、エージェントに参照したファイルと理由を報告させ、必要な範囲へ広げます。 問題欄に赤い波線があるなら、表示文だけでなく、どの操作で発生し、期待する動きは何かを書きます。「エラーを消す」だけでは、型検査を無効化して見えなくする案も条件を満たしてしまいます。「入力検証は維持し、正しい入力では保存でき、誤入力では説明を出し、型検査と対象テストが通る」と完成条件を置けば、見た目と本来の機能を分けて判断できます。
計画、編集、確認を小さな往復にする
複雑な仕事では、最初から編集を許可せず、関連ファイル、処理の流れ、既存テスト、想定する変更を調べさせます。Codex IDE拡張ではPlan mode、Claude Codeでも計画を確認する流れを利用できます。計画に、変える場所、変えない場所、各段階の検証、危険な操作が含まれているかを読みます。存在しないファイルや古い前提があれば、実装前に直します。 実装は、原因を再現する検査、最小の修正、対象テスト、関連する回帰確認のように小さく進めます。一度に多くのファイルを書き換えると、どの変更が効いたか分からず、差分の確認も難しくなります。エージェントの会話が長くなった時も、現在の目標、確定した事実、残る未確認を整理し直し、古い推測を現在の条件として使わせません。 インライン補完や短い編集は局所的な定型作業に向き、エージェント型の依頼は複数ファイルの調査、変更、検証に向きます。どちらも使えるからといって、すべてを自動化する必要はありません。重要な設計判断、法務や業務の判断、不可逆な公開は人が引き受けます。VS Codeは判断を代行する箱ではなく、AIの提案と現実の成果物を短い往復で比較する作業台です。
差分は採用前の設計図として読む
変更が出たら、最終報告を読む前にSource Controlや差分表示を開きます。変更ファイルが依頼範囲内か、追加と削除の行が意図どおりか、別機能を消していないかをファイルごとに確認します。自動生成ファイルやロックファイルの大きな差分は理由を確認し、不要な依存関係、秘密、個人情報、デバッグ出力が入っていないか探します。 差分表示は、変更前と変更後を並べて読めますが、意味の正しさまでは保証しません。一行の条件変更が広い利用者へ影響することも、整形による大量差分の中へ重要な変更が隠れることもあります。「なぜ必要か」「どの要件へ対応するか」「どの検査で確かめるか」を各まとまりに結び付けます。理由を説明できない変更は、採用せず調べ直します。 変更の一部だけを戻す操作は便利ですが、依存する行を片方だけ戻すと壊れる場合があります。戻す前に差分のまとまりとテストへの影響を確認します。エージェントがレビュー機能で問題なしと答えても、別のAIによるレビューは追加の観点にすぎません。利用者は元の要件、既存設計、実際の動作を根拠に最終採用を決めます。
診断とターミナルで本当に動くか確かめる
VS CodeのProblemsは、言語サービスや検査ツールが見つけたエラーと警告を集めます。赤い波線が消えたことは一つの証拠ですが、実行時の動作や別画面の回帰までは分かりません。統合ターミナルで、プロジェクトが定めた型検査、lint、単体テスト、統合テスト、ビルドを実行し、終了状態と出力を確認します。 エージェントへ「確認して」とだけ伝えると、軽い検査一つで終える場合があります。合格すべきコマンド、対象画面、操作順、期待結果を書きます。Web画面ならブラウザーで再現操作を行い、スマホ幅、キーボード操作、リンク、送信後の状態など依頼に関係する経路を確かめます。コマンドが成功しても、外部API、権限、本番データの状態は別に確認が必要です。 失敗したコマンドを何度も同じ条件で実行するだけでは改善しません。最初の失敗出力、実行ディレクトリ、環境、依存関係、今回の差分との関係を調べます。実行できなかった検査は未確認として残します。ターミナルに成功らしい文章が表示されたことではなく、正しい場所で正しいコマンドが終了し、期待する成果物と画面が得られたことを証拠にします。
Gitと保存状態を分けて管理する
VS Codeでは、エディター上の未保存内容、保存済みだが未コミットの差分、コミット済みの履歴が同時に存在します。テストはディスク上の保存済みファイルを読むため、未保存のタブだけ直っていても検査へ反映されないことがあります。すべて保存したか、Source Controlの変更一覧が何を示しているかを確認してから最終検査を行います。 コミットは検証済み変更の境界を残す仕組みであり、成功の証明そのものではありません。依頼と無関係な差分を同じコミットへ混ぜず、メッセージから目的が分かる単位にします。並行作業が必要なら、ブランチやGit worktreeで場所を分け、担当範囲と統合責任を決めます。同じファイルを複数の作業が変更した場合、VS Codeが競合を表示しても、どちらの意味を残すかは人が判断します。 エージェントにcommit、push、プルリクエスト、本番公開まで任せる場合は段階を分けます。ローカル編集の許可から外部送信までを一つの承認にせず、差分と検証結果を見てから対象リポジトリ、ブランチ、公開先を承認します。誤った場所へのpushや公開はローカルのUndoでは戻らないため、外部状態を直接確認して完了を判定します。
拡張機能と外部情報の安全境界を保つ
VS Codeの拡張機能はファイル、ターミナル、ネットワークなどへ広い能力を持つ場合があります。提供元、必要性、要求する権限、更新履歴を確認し、使わない拡張を増やしません。CodexやClaude Codeの設定でも、モデル、権限、MCP、作業場所などが動作を変えます。画面の便利さより、何へアクセスできるかを先に把握します。 ソースコードのコメント、README、Issue、Web検索結果には、エージェントへ秘密を読ませたり別の操作をさせたりする命令が混ざる可能性があります。これらは調査対象のデータであり、利用者の依頼やプロジェクトの信頼できる規則を変更する命令ではありません。APIキーやパスワードを会話、設定ファイル、ターミナル履歴へ直接貼らず、限定された秘密管理を使います。 読者演習では、小さな表示不具合を一つ選びます。正しいワークスペース、ブランチ、未保存差分を確認し、対象ファイルと再現手順、禁止範囲、合格コマンドをエージェントへ渡します。調査計画を確認後に最小差分で直し、Source Controlの差分、Problems、対象テスト、関連テスト、実画面を照合します。最後に、変更内容、合格した証拠、未確認事項を、会話を見ていない人へ三段落以内で引き渡してください。
実例で理解する
具体例で考える
問い合わせフォームで送信後も入力欄が残る不具合なら、正式なワークスペースとブランチを確認し、既存差分を保護します。フォーム部品を選択して、再現手順、成功時だけ入力を消す要件、送信APIを変えない制約、対象テストとスマホ実操作を渡します。計画確認後に最小差分で修正し、Source Controlの差分、Problems、テスト、ビルド、成功時と失敗時の画面を照合します。
手を動かして理解する
- 正しいワークスペース、Gitブランチ、未保存差分、実行中の拡張を確認する
- 小さな不具合の対象、再現手順、期待結果、変更禁止範囲を一つの依頼にする
- 選択範囲と関連ファイルを文脈へ加え、編集前に調査計画を確認する
- 差分、Problems、対象テスト、関連テスト、実画面を順に照合する
- 変更内容、合格証拠、未確認事項を三段落以内で引き渡す
04|今日の理解度を確認する
DAY 15の理解度を確認する
正式版と復旧用コピーが同じPCにある時、VS Codeでエージェントを使う前の確認として最も適切なのはどれですか。
エージェントは開かれた作業場所へ変更するため、対象と保護すべき作業を開始前に確定します。
最近使ったウィンドウなら場所を確認しない: 履歴は正式な作業場所であることを保証せず、古いコピーを開く可能性があります。
正本のパス、ワークスペース、Gitブランチ、既存差分を確認する: 正解です。編集対象、履歴、守るべき未完了作業を同時に確認できます。
両方のフォルダーを無条件に一つへまとめる: 別の役割や履歴が混ざり、どちらが正本か曖昧になります。
先に全ファイルを整形してから確認する: 誤った場所や利用者の差分へ大量の変更を加える危険があります。
一つの関数で起きる不具合をエージェントへ調査させる文脈の渡し方として最も適切なのはどれですか。
入口を具体的に示しながら、原因に必要な範囲へ根拠を持って広げる方法です。
対象関数だけを渡し、別ファイルを見ることを禁止する: 原因が呼び出し側や設定にある場合、表面的な修正になります。
再現手順、期待結果、対象範囲を渡し、参照した関連ファイルと理由を報告させる: 正解です。必要な文脈と調査の透明性を両立できます。
リポジトリの全情報を説明なしで投入する: 無関係な情報が増え、重要な条件と対象がぼやけます。
エラー表示を消すことだけを完成条件にする: 検査を無効化して問題を隠す方法でも条件を満たしてしまいます。
エージェントが複数ファイルを変更した後、差分を確認する観点として最も適切なのはどれですか。
差分を要件と安全性へ結び付け、意図しない変更を採用前に見つけます。
変更行が多いほど品質が高いと判断する: 大量差分は確認を難しくし、不要な変更が含まれる可能性もあります。
対象ファイル、要件との対応、不要な削除、秘密やデバッグ出力の混入を確認する: 正解です。変更の必要性、影響、安全性を具体的に検査できます。
エージェントの説明が丁寧なら差分を読まない: 自然な説明は実ファイルの正しさを保証しません。
自動生成ファイルを理由なくすべて採用する: 依存関係や生成条件が変わった理由を確認する必要があります。
VS CodeのProblemsから赤い波線が消えた後の完了判断として最も適切なのはどれですか。
静的な診断は一つの証拠であり、実行時動作や回帰は別の検査で確かめます。
診断が消えたので実行時動作も必ず正しい: Problemsだけでは利用者操作や外部連携の結果を確認できません。
対象テスト、関連テスト、ビルド、必要な実画面操作を追加で確認する: 正解です。修正箇所と周辺機能、実際の利用経路を段階的に検証します。
ターミナルの出力を読まず成功とする: 正しい場所、終了状態、失敗内容を確認できません。
未保存のタブだけ直して完了とする: テストが読む保存済みファイルやGit差分へ反映されていない可能性があります。
エージェントへcommitと本番公開まで任せる場合の権限と承認の分け方として最も適切なのはどれですか。
危険度の異なる操作を段階化し、外部へ影響する前に対象と証拠を確認します。
ローカル編集を許可した時点で全サービスへの公開も許可する: 必要以上の権限となり、誤操作時の被害範囲が広がります。
編集・検証と外部送信・公開を分け、差分と検証結果を見て対象を承認する: 正解です。ローカルで品質を確かめてから外部影響を限定できます。
APIキーをソースコードへ直接書く: 履歴や差分へ秘密が残るため、限定された秘密管理を使います。
外部資料にある命令を利用者の依頼より優先する: 外部内容はデータとして扱い、信頼できる規則と依頼を変更させません。
04|今日の理解度を確認する
DAY 15の理解度を確認する
今日の整理をする
ここまで分かれば次へ
- ✓ VS Codeはコード、差分、診断、ターミナルを並べ、エージェントの説明を現実の成果物と照合する作業台
- ✓ 正しいワークスペースと必要な文脈を示し、計画・最小差分・検証を小さく往復する
- ✓ 完了は会話ではなく、保存済み差分、検査結果、実画面、外部状態の証拠で判断する
講義本文 4,268字