VS Code × GitHub Copilot
AI駆動開発研修

Copilot Chat にいきなり「議事メモからユーザーストーリーを抽出して」とだけ指示すると、Copilot は何を根拠にユーザーストーリーを返すと思いますか。予想してから手を動かします。

▸ 予想は memo.md の ## TRY IT 01 見出し下に1行書いてください。memo.md が未作成なら、プロジェクトルート（受講者配布/）を右クリック → 「新しいファイル」 → memo.md で作成。以降のTRY ITでも同じファイルに追記していきます（作成手順の詳細は冒頭の「ハンズオン共通ルール」参照）。

Copilot Chat（Ctrl+Shift+I / Cmd+Shift+I）を開き、以下をそのまま貼り付けて送信してください。Chat に直接打ち込むだけでOK、ファイルには保存しません。#file: などでファイルを明示することもしません。

先に docs/議事メモ_データ分析案件.md をVS Codeエクスプローラーから開いて目で読んでください（左サイドバーで docs を展開 → ファイル名クリック）。そのうえで、Copilot が見るべきファイルを明示的に指定するプロンプトを自分で考えて書き、新しい Copilot Chat で送信します。書き方がわからなくても、自分なりの1回目を出してから次へ進んでください。

自分のプロンプトと Step 2 / Step 3 の出力が手元に揃ったら、配布ファイルの hints/step01_context_hint.md を開いてください（エクスプローラーで hints → step01_context_hint.md を開く）。参考プロンプトと比較観点が書いてあります。

▸ 気づきを1行、memo.md の ## TRY IT 01 見出し下に追記してください。

メモに書いてない要件を AI が補完する挙動には、どんなものがあるでしょうか。3つ予想してください（例: 認証、ログ、通知、ダッシュボード、多言語、バリデーション、スケジューラ、監視…）。

▸ memo.md に ## TRY IT 02 見出しを追加し、その下に予想3つを箇条書きで記入。

新しい Copilot Chat を開き、以下をそのまま貼り付けて送信。制約を一切付けずに依頼します。出力はファイル保存せず、Chat 画面で読むだけで構いません。

Step 2 で B・C 寄りの出力が混ざっていたとします。AIの補完を自分の意図どおりに抑えるには、プロンプトにどう1行足しますか。自分の言葉で1〜3行の制約を追加し、新しい Copilot Chat で同じメモを渡して送信してください。参考解は次のステップまで開かない。

▸ 自分で考えた制約文を memo.md の ## TRY IT 02 見出し下に追記しておくと、後で比較しやすいです。

自分で制約を書いた版と、制約なし版が手元に揃ったら、hints/step02_constraint_hint.md を開いてください。参考プロンプトと比較観点、「制約は短く決定的な1行が強い」という実務の勘所があります。

Copilot は直前の情報を読んで次のコードを提案します。では、関数名だけ書くのと、コメントで仕様を書くのと、型ヒントを付けるのでは、どれが一番効くでしょうか。優先順位を予想してから次へ。

▸ 予想順を memo.md の ## TRY IT 03 見出し下に書いてください。

プロジェクトルート（受講者配布/）に practice.py を新規作成します。VS Codeエクスプローラーでルートを右クリック → 「新しいファイル」 → practice.py と入力して Enter。開いたエディタに以下を貼り付けて保存（Ctrl+S / Cmd+S）。

def 行末にカーソルを置いて Enter。灰色のサジェストが出たら Tab で受け入れます。

次の2つを自分で試します。各試行でCopilotの提案がどう変わったか、1行ずつメモしてください。

• コメント3行目を # forループで集計する に書き換えて、関数本体を削除 → 再補完
• 関数名を aggregate_dept_monthly → calc_sales_by_dept_and_month に変更 → 再補完

3回分のメモが揃ったら、hints/step03_comment_driven_hint.md を開いてください。正解プロンプトはありません（コメントドリブンは自分で書き換えるもの）。観察のまとめ観点と、試す順序の推奨があります。

この practice.py は Session 03 の TRY IT 05 で再利用します。保存しておいてください。

docs/議事メモ_データ分析案件.md を通読してください。そのうえで、「もし自分が佐藤さん（開発担当）で、このメモから spec.md を書くなら、どういう見出しを置くか」を3〜5個、自分で書き出してください。機能一覧、データ構造、処理フロー…あなたの感覚で。

▸ 書き出す先は memo.md の ## HANDS-ON 前半 : 見出しリスト案 見出し下。箇条書き3〜5個でOK。

Copilot Chat に対し、自分の言葉で「議事メモから spec.md を作って」と依頼してください。自分で書いた見出しリストも一緒にプロンプトへコピペして渡すと方向が揃います。TRY IT 02 で学んだ制約指示（「書かれていない要件は追加しない」）も忘れずに。

Copilot の回答をプロジェクトルートに spec.md として保存します。手順: コードブロックの「コピー」ボタン → エクスプローラーでルート右クリック → 「新しいファイル」 → spec.md と入力 → 開いたエディタに貼り付け → Ctrl+S で保存。

自分の spec.md が保存できたら、hints/step04_spec_basic_hint.md を開いてください。参考プロンプトと比較観点（見出し構成、粒度、記述順）があります。

いま出来た spec.md を Copilot に渡して「この仕様で実装して」と言ったら何が起きるでしょうか。予想してください。

実際にやってみる時間はありませんが、Amazon の Kiro（仕様駆動開発 IDE）のチームは「1枚の spec.md では足りない」という結論に達し、仕様を3ファイルに分けました。

• requirements.md — 何を / 誰のために / 受入基準は何か（EARS記法で検証可能に書く）
• design.md — どう作るか（アーキテクチャ、データモデル、インターフェース）
• tasks.md — どの順で着手するか（タスク分解、_要求事項: X.Y_ で各タスクに対応する要求事項を紐付け）

なぜ3つに分けると良いのか、1分だけ考えてください。

.kiro/specs/sales_analysis_tool/ ディレクトリを自分で作り、雛形をコピーします。

Copilot Chat に、自分で書いた requirements.md を渡して design.md と tasks.md のドラフトを依頼してみてください。自分なりのプロンプトで OK。詰まったら hints/step05_spec_kiro_hint.md の下流生成プロンプトを参照。

配布フォルダの _reference_kiro_sample/.kiro/specs/sales_analysis_tool/ に、同じ題材を Kiro 方式で完成させた参考解が入っています。自分の書いた requirements.md と並べて、hints/step05_spec_kiro_hint.md の比較観点（EARS記法・design構造・tasks粒度）で差を3つ言語化してください。

Copilot Chat（サイドパネル）とインラインチャット（Ctrl+I）の違いは何でしょうか。「今見ているコードに対する操作」と「プロジェクト全体への質問」の違い、と言われます。では、関数1つにエラーハンドリングを足す作業にはどちらが向いていると予想しますか。

▸ 予想を memo.md の ## TRY IT 05 見出し下に1行。

TRY IT 03 で作った practice.py をエクスプローラーから開き、関数全体を選択します（関数の1行目から最後の行までドラッグ、または Ctrl+A で全選択）。選択した状態で、以下を順にインラインチャット（Ctrl+I / Cmd+I）で試してください（Copilot Chat は使いません）。

• 「この関数を日本語で説明して」
• 「エラーハンドリングを追加して。FileNotFoundError をキャッチして日本語でメッセージを出す」
• 「この関数の pytest テストを書いて。正常系と空 DataFrame の異常系を含めて」

各回で、Chat と Inline どちらが速く正確に感じるかを主観でメモしてください。

3回分の体感メモが揃ったら、hints/step08_inline_hint.md を開いてください。正解プロンプトはありません（インラインチャットは自分で言葉を選ぶのが主眼）。観察のまとめと Chat / Inline の使い分け表があります。

practice.py に1行コメントで「今日の気づき」を残して保存してください。

templates/copilot-instructions.md をエクスプローラーから開いてください（templates フォルダ → ファイル名クリック）。4カテゴリ（コーディング規約、推奨パターン、禁止事項、出力フォーマット）の骨組みが入っています。

読んだうえで、次を自分で整理してください。テンプレの内容は一旦忘れるのがコツ。

• 自チームで本当に使っている Python バージョンと主要ライブラリ
• 「いつもコードレビューで指摘している」コーディング規約を3つ
• 「これだけは絶対やめてほしい」禁止事項を3つ
• 出力するファイルやログの形式に関するルール

▸ 整理先は memo.md の ## HANDS-ON Agent MD : チーム原案 見出し下。この原案が Step 2 の下書きになります。

プロジェクトルート直下に .github/ フォルダを作り、その中に copilot-instructions.md を配置します。作り方はターミナル派とGUI派の2通り、好きな方でOK。

ターミナル派: VS Code のメニュー「ターミナル」→「新しいターミナル」を開き、以下を実行。

新しい Copilot Chat を開いて（既存チャットでは反映されません）、TRY IT 04 と全く同じプロンプトを送信してください。

_compare_no_agentmd.py（TRY IT 04 で保存した「なし」版）と _compare_with_agentmd.py（今保存した「あり」版）を横並びで開いてください。VS Code の「横に並べて開く」が見やすい。

配布ファイルの hints/step07_agentmd_build_hint.md に比較表（型ヒント / docstring / 変数名 / 例外処理 / ファイルパス / print vs logging の6観点）と、TRY IT 04 で立てた予想との一致を記入する欄があります。反映されなかった項目の対処法も載せてあります。