AIに8割書かせたコードを、半年後の自分が保守できるようにするために実際にやっていること
この記事で分かること
AIが生成したコードを半年後に自分が保守できる状態に保つための実践手法が得られる。具体的には、コードの構造化ルールやコメントの付け方、AIに指示する際のプロンプト設計の工夫が含まれる。
詳細要約
AIが生成したコードを長期保守可能にするには、生成直後に「意図を明示するコメント」と「テストコード」を追加することが最も効果的だ。具体的には、AIに処理の目的や前提条件を日本語でコメントとして出力させるプロンプト（例：「各関数の冒頭に、引数・戻り値・想定外の入力への対処をコメントで記述して」）を加える。また、生成されたコードに対して、境界値やエラーケースを含む単体テストを手動で補い、半年後でも動作確認できる状態を保つ。