生成AIプログラミング入門編 ハンズオン配布フォルダ


■ 1. このフォルダの中身

genai-nyumon-handson/
├── はじめにお読みください.txt   このファイル
├── 資料/                        事前セットアップガイドと手元ガイド共通編のPDF 2本
└── handson/                     当日手を動かすファイル一式

演習で触るファイルは、すべて handson フォルダの中にあります。


■ 2. 研修当日までにやること

(1) 資料/01_事前セットアップガイド.pdf を最後まで進めてください。
    VSCode、JDK 17、Claude Code の導入と、Amazon Bedrock への接続設定が
    含まれます。所要はおよそ2時間です。接続情報は研修事務局から別途ご案内します。

(2) 導入が済んだら、handson/kadaiB フォルダで次を1回だけ実行してください。

      Windows      .\mvnw.cmd -q -DskipTests package
      Mac / Linux  ./mvnw -q -DskipTests package

    当日使う部品を先にダウンロードしておくための操作です。初回は数分かかります。
    BUILD SUCCESS と表示されれば完了です。当日の待ち時間がなくなります。


■ 3. 教材ファイルの開き方

PDF は Acrobat Reader などの一般的なリーダーで開けます。
handson フォルダの中の .md ファイルは、VSCode で開いて読んでください。
右上のプレビューボタン（虫めがねに紙のアイコン）を押すと整形された状態で読めます。


■ 4. 当日の最初の操作

(1) VSCode を起動します。
(2) 「ファイル」→「フォルダーを開く」で handson フォルダを開きます。
    genai-nyumon-handson でも kadaiA でもなく、handson です。
(3) 「このフォルダー内のファイルの作成者を信頼しますか?」と聞かれたら
    「はい、作成者を信頼します」を選びます。
(4) 左側のアクティビティバーから Claude Code のパネルを開きます。

この状態で講師の合図をお待ちください。


■ 5. 答え合わせについて

handson/hints/ に、詰まったときの参考プロンプトが入っています。
先に開いても失格にはなりませんが、自分の言葉で1回試してから開くほうが
手元に残ります。10分考えて動かなければ開いてください。

handson/_harness_kit/ は、演習の途中で講師の合図があってから使います。
当日まで開かずに置いておいてください。


■ 6. 教材ページ

当日の投影スライドと手元ガイドは、Webページでも公開しています。
URL は研修事務局からのご案内をご確認ください。
（事務局の方へ：配布前にこの行を公開URLへ差し替えてください）


■ 7. 困ったときは

事前セットアップでつまずいた場合は、まず
資料/01_事前セットアップガイド.pdf のトラブルシューティングをご確認ください。
症状から引ける形で14件まとめています。

解決しない場合は、次の3点を添えて研修事務局までご連絡ください。

  ・お使いの OS（Windows 11 / macOS など）
  ・どの手順で止まったか（セッション番号）
  ・画面に出ているエラーメッセージ（スクリーンショットでも構いません）

連絡先は研修事務局からのご案内をご確認ください。
（事務局の方へ：配布前にこの行を連絡先へ差し替えてください）
