ハンズオンガイドGitHub CopilotによるAI駆動開発

コード補完は、コメントとメソッド名から次の数行を予想して、薄い文字で出します。1つのメソッドを書くくらいの大きさなら、チャットを開くより早く終わります。

1. skillsheetフォルダを開いたVS Codeで、YearsFormatter.javaを開きます。
2. throw new UnsupportedOperationExceptionの行を消します。
3. 空いた行にif (years == null) {と入力し、薄い文字の続きが出るのを待ちます。
4. 続きがJavadocのとおりであればTabで受け入れ、違っていればEscで消して自分で書きます。
5. メソッドの最後まで、同じように受け入れるか書くかを選びながら進めます。

if (years == null) {
    return "未登録";
}
if (years < 1) {
    return "1年未満";
}
if (years >= 10) {
    return "10年以上";
}
return years + "年";

• Javadocに書かれた「1年未満」「10年以上」「未登録」の3つの場合を、メソッドが返す
• 薄い文字の候補を、受け入れたか消したかを自分で選んだ

チャットのAskは、ファイルを書き換えずに質問へ答えます。初めて触るコードの役割を、ファイルを指定して聞くと、読む順番の見当が付きます。

1. チャットのビューを開き、入力欄の下のエージェントの選択でAskを選びます。
2. 下の文面をコピーして入力欄に貼り、送ります。
3. 返事を読んだら、EngineerRepository.javaを開き、findAllSkillsのSQLを選択します。
4. 入力欄に「#selection このSQLは何を取得していますか。結合している2つのテーブルの役割も書いてください」と入れて送ります。

#file:src/main/java/com/example/skillsheet/engineer/EngineerService.java
このクラスが何をしているかを3行で説明してください。
findAllの中で、技術者とスキルをどうまとめているかも書いてください。

• EngineerServiceが、技術者の一覧とスキルの一覧を技術者のIDでまとめていると説明できる
• チャットのAskでは、ファイルが書き換わらないことを確かめた

エージェントは、ファイルを作り、ビルドとテストのコマンドまで実行します。1行の依頼から、Copilotがどこまで自分で決めるかを見ます。

1. メニューのFileからNew Windowを選び、新しいウィンドウでvibeフォルダを開きます。
2. チャットのビューを開き、エージェントの選択でAgentを選びます。
3. vibe/README.mdの「依頼の候補」の3つから1つを選び、そのまま入力欄に貼って送ります。
4. コマンドの実行の確認が出たら、java tools/Build.javaで始まることを確かめてから許可します。
5. Copilotの報告が終わったら、チャットの上に並んだ変更のファイルを1つずつ開き、変わった箇所を見ます。
6. 残す変更はKeep、戻す変更はUndoを押します。
7. ターミナルでjava tools/Build.java runを実行し、ブラウザでhttp://localhost:8080/を開きます。

日報アプリを作って。日付と作業内容と作業時間を登録して、一覧で見られるようにして
備品の貸出アプリを作って。備品の一覧と、誰がいつ借りたかを記録できるようにして
社内勉強会の参加登録アプリを作って。勉強会の一覧と、参加したい人の登録ができるようにして

• ブラウザで一覧が表示され、登録した内容が一覧に増える
• Copilotが自分で決めたことを、画面から2つ挙げられる（項目の単位、並び順など）

同じアプリに、仕様を3行書いたメモを渡して直してもらいます。メモに書いたことと、画面で起きたことを1つずつ見比べます。

1. vibe/spec.mdを開き、コメントの候補AからHのうち3つを選んで、「- 」の行に書き写します。
2. アプリを起動している場合は、ターミナルでCtrl+Cを押して止めます。
3. 下の文面を、チャットの入力欄に貼って送ります。
4. Copilotの報告が終わったら、アプリを起動し、選んだ3つの仕様をブラウザで1つずつ操作して確かめます。

#file:spec.md の仕様どおりに、作ったアプリを直してください。
直したら、仕様の3つを確かめるテストを書いて、java tools/Build.java test で実行してください。

• spec.mdの3つの仕様を、ブラウザの操作で1つずつ確かめた
• 1行の依頼とメモを渡す依頼で、直す回数が少なかった方を1文で言える

営業担当の依頼文に、追加する要件を2つ足してから、requirements.mdを書かせます。受入基準は「〜のとき、システムは〜する」というEARSの形で書かれるので、1行ずつテストに置き換えられます。

1. specs/matching/request.mdを開き、「追加する要件」の候補AからIのうち2つを選んで、「- 」の行に書き写して保存します。
2. チャットで新しいチャットを始め、下の文面を送ります。
3. できたrequirements.mdを開き、選んだ2つが要件に入っているかと、最後の「確認したいこと」を読みます。
4. 「確認したいこと」のうち、決め方を変えたい項目があれば、requirements.mdを自分で直して保存します。

/spec-requirements specs/matching

• request.mdで選んだ2つの要件が、requirements.mdの要件に入っている
• 「確認したいこと」の項目を読み、直すかどうかを決めた

要件から設計を書かせ、続けて実装の手順をtasks.mdに分けさせます。タスクは、Copilotに1回頼んで終わる大きさの4〜6個になります。

1. 同じチャットに/spec-design specs/matchingを送ります。
2. design.mdの「判定のルール」を開き、候補に入る条件が自分の理解と合っているかを確かめます。
3. 続けて/spec-tasks specs/matchingを送ります。
4. tasks.mdを開き、各タスクの「終わったと判断する条件」を読みます。

/spec-design specs/matching
/spec-tasks specs/matching

• tasks.mdに、チェックの無いタスクが4〜6個ある
• 各タスクに、終わったと判断する条件が書かれている

タスクの番号を指定して、1つずつ実装させます。Copilotはタスクの範囲だけを実装し、テストが成功したらtasks.mdにチェックを付けます。

1. 下の文面を送り、タスク1を実装させます。
2. 報告とtasks.mdのチェックを確かめたら、番号を2に変えて送ります。
3. 同じように、最後のタスクまで1つずつ進めます。
4. アプリを起動し、ブラウザでhttp://localhost:8080/projectsを開いて、案件名を押します。

/spec-run-task specs/matching 1

• tasks.mdのすべてのタスクにチェックが付いている
• 案件1の候補が、必要スキルのJavaとSpring BootとSQLをすべてレベル3以上で持つ人になっている

営業担当から「開始日に間に合わない人は候補から外してほしい」と追加の依頼が来た場面です。コードを直接直さずに、仕様書を先に直させ、足されたタスクを実装させます。

1. 下の文面の1行目を送り、3つの仕様書を直させます。
2. tasks.mdの末尾に、チェックの無いタスクが足されたことを確かめます。
3. 足されたタスクの番号で/spec-run-taskを送り、1つずつ実装させます。
4. ブラウザで案件1の画面を開き直し、候補の人数が変わったことを確かめます。

/spec-update specs/matching 参画可能日が案件の開始日より後の人は、候補から外す。参画可能日が未登録の人は候補に残す
/spec-run-task specs/matching 6

• requirements.mdとdesign.mdに、「（変更11/17）」の付いた箇所がある
• 案件1の候補から、開始日より後に参画できる人が外れた