サンプルリポジトリの準備
ハンズオンを始める前に、AIレビューの対象となるサンプルリポジトリを用意しておきます。プルリクエストを出す前提のリポジトリなので、main ブランチには最小限のコードだけを置き、実際のレビュー体験は別ブランチのプルリクエストで行います。
1. フォルダの作成
本章専用の作業フォルダを作成します。任意の場所に ai-review-handson フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した ai-review-handson フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。
ai-review-handson ← このフォルダを作成
2. 初期コードの作成
まずはレビュー対象の起点となる最小限のPythonアプリケーションを作成します。あとで別ブランチで意図的に問題のある変更を加えて、AIがそれをどう指摘するかを確認します。
Visual Studio Codeのエクスプローラーで ai-review-handson フォルダを右クリックし、「新しいファイル」から app.py を作成します。
ai-review-handson
└── app.py ← このファイルを作成
作成したファイルに以下の内容を記述して保存します。
def calculate_total(items: list[dict]) -> int:
"""商品リストの合計金額を計算する"""
total = 0
for item in items:
total += item["price"] * item["quantity"]
return total
このコード自体にも、price や quantity が欠けたときの例外処理、負の値のバリデーション、list[dict] の dict の中身が明示されていない型ヒント、docstringの引数・戻り値の説明といった改善余地が残っています。あとの手順でより明確な問題を含む変更を加え、これらと合わせてAIレビューがどこまで指摘してくるかを見ていきます。
3. GitHubリポジトリの作成
GitHub Actionsを動かすには、その入れ物となるGitHubリポジトリにコードが乗っている必要があります。本章専用の検証用リポジトリを新規作成します。
ブラウザで GitHubの新規リポジトリ作成画面 を開き、以下の設定でリポジトリを作成します。
General
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| Owner | ご自身のGitHubユーザ名 | 個人アカウント配下に作成する |
| Repository name | ai-review-handson |
Anthropic Consoleのフェデレーションルールで指定したリポジトリ名と一致させる |
| Description | 空欄でよい | 用途がわかる短文を入れてもよい |
Configuration
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| Choose visibility | Private | AIレビューの検証用途なので外部公開しない |
| Start with a template | No template | テンプレートは使わない |
| Add README | Off | ローカルで先にコードを作った状態からPushするため、GitHub側でファイルを作らせない |
| Add .gitignore | No .gitignore | 同上 |
| Add license | No license | 同上 |

「Create repository」をクリックして作成します。
作成直後、リポジトリのトップページに「Quick setup」ブロックと、その下の「…or push an existing repository from the command line」ブロックが表示されます。後者に git remote add origin ... から git push -u origin main までのコマンドが載っているので、次の手順ではこの git remote add origin ... のリポジトリURLをコピーして使います。

4. ローカルからのPush
先ほど作成したGitHubリポジトリに、ローカルのコードをPushします。
以下のコマンドで、Git がインストールされていることを確認します。
git --version
以下のように Git のバージョンが表示されれば、インストールは確認できています。
git version 2.x.x
バージョンが表示されない場合は、Git/GitHubのセットアップ を先に実施してください。
インストールが確認できたら、ローカルでGitリポジトリを初期化します。
git init
ファイルをコミットします。
git add app.py
git commit -m "Add initial calculate_total"
リモート設定とPushを行います(<your-username> をご自身のGitHubユーザ名に置き換えてください)。
git remote add origin https://github.com/<your-username>/ai-review-handson.git
git branch -M main
git push -u origin main
GitHubのリポジトリページで app.py がコミットされていれば、リポジトリの準備は完了です。
