[Claude Code] 入門講座 #7：Claudeでコードレビューをしてもらう実験 〜AIに読んでもらう“自分のコード”〜

#!/usr/bin/python3.8
# -*- coding: utf-8 -*-
import sys, re, glob, ffmpeg
TYPE:str = "mp3"
FILE_PATH:str  = "/home/smb/*.[Mm][Pp]4"

# mp4 -> [mp3][wav]
def mp4_to_mp3(path,type):
    ffmpeg.run(
        ffmpeg.output(
            ffmpeg.input(path) ,
            re.sub("\.(mp4|MP4)$","."+type,path)
        ))

if ( __name__ == "__main__" ):
    [mp4_to_mp3(path,TYPE) for path in glob.glob(FILE_PATH)]

あなたは優れたソフトウェアエンジニアです。
以下のPythonコードをレビューしてください。
・改善点や冗長な箇所
・バグの可能性や例外処理
・可読性や保守性の視点
・実行環境:linux(ubuntu)

[python]
# ここにコード

以下のPythonコードをレビューしてください。
補足：実行環境はlinux(ubuntu)
・改善点や冗長な箇所
・バグの可能性や例外処理
・可読性や保守性の視点


# ここにpythonコード

#!/usr/bin/python3.8
# -*- coding: utf-8 -*-
import sys
import re
import glob
import ffmpeg
from pathlib import Path
from typing import List

# 定数は大文字のままで良いですが、型ヒントを改善
OUTPUT_TYPE: str = "mp3"
INPUT_DIR: Path = Path("/home/smb")
INPUT_PATTERN: str = "*.[Mm][Pp]4"

def convert_mp4_to_audio(input_path: Path, output_type: str) -> None:
    """Convert MP4 video to audio format (mp3/wav)

    Args:
        input_path: Input MP4 file path
        output_type: Output audio format (mp3/wav)

    Raises:
        ffmpeg.Error: When conversion fails
    """
    try:
        output_path = input_path.with_suffix(f".{output_type.lower()}")
        ffmpeg.run(
            ffmpeg.output(
                ffmpeg.input(str(input_path)),
                str(output_path)
            )
        )
    except ffmpeg.Error as e:
        print(f"Error converting {input_path}: {e.stderr.decode()}", file=sys.stderr)
        raise

def main() -> None:
    input_files: List[Path] = list(INPUT_DIR.glob(INPUT_PATTERN))

    if not input_files:
        print("No MP4 files found", file=sys.stderr)
        return

    for file_path in input_files:
        try:
            convert_mp4_to_audio(file_path, OUTPUT_TYPE)
            print(f"Successfully converted: {file_path}")
        except ffmpeg.Error:
            continue

if __name__ == "__main__":
    main()

## はじめに
この回では、実際に作成したコードをAIにレビューしてもらい、どのように改善提案を受けられるかを体験しました。

## 対象のコード


# Claudeに送ったコードをここに貼る

Claudeのレビュー結果（要約）
❗ バグの可能性：〇〇行目の〇〇

🔧 冗長な記述の簡略化提案

🧼 コードの可読性を高めるネーミング

✅ 安全性を高める try-except の追加提案

修正後のコード（Claudeの提案を反映）


気づきと感想
Claudeによるレビューで得られた気づきや「人に読まれるコードを書くこと」の難しさと価値について。