サンプルリポジトリの準備

ハンズオンを始める前に、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 がコミットされていれば、リポジトリの準備は完了です。