【要約】AIにCSV→Markdown変換ツールを作らせたら、先頭の空行1つで全データが消えていた [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者がClaude Codeを用いてCLIツールを自動生成した際、特定の入力条件下でデータが消失する問題に直面した。AIは一見堅牢なコードを生成するが、論理的なエッジケースを見落とすリスクがある。具体的には以下の問題が発生した。
- ・先頭に空行があると、ヘッダー行が「0列」と誤判定される。
- ・その結果、後続の全データが0列として切り捨てられ、データが消失する。
- ・エラーが出力されず、空の表が表示されるため、不具合の発見が困難である。
- ・非対話実行時にAIがファイル編集権限を求め、プロセスが停止する。
// Approach
筆者はAIが生成したコードの信頼性を検証するため、意地悪な入力を用いたテストを実施した。その後、発生したバグを解消するために指示内容を工夫した。具体的な手順は以下の通りである。
- ・9パターンの特殊な入力（パイプ文字、列数不一致等）で堅牢性を検証した。
- ・「先頭空行」というエッジケースを特定し、不具合を再現した。
- ・修正依頼の際、ファイル直接編集ではなく「修正済みコードのテキスト出力」を指示した。
- ・これにより、対話待ちによる停止を回避し、1ターンでの修正を実現した。
// Result
指示方法を最適化したことで、非対話環境でもスムーズに修正を完了できた。修正後のコードは、エッジケースを克服しつつ、既存の動作も維持している。具体的な成果は以下の通りである。
- ・修正コード：
rows = [row for row in reader if len(row) > 0] - ・修正により、先頭の空行を読み込み時に適切にスキップできるようになった。
- ・修正後も、最初に検証した9パターンのテストをすべてパスした。
- ・非対話実行における、AIへの適切な指示設計の有効性を証明した。
Senior Engineer Insight
> AIによるコード生成は、防御的な実装を初手で行う点で極めて優秀だ。しかし、エラーを出さずに失敗する「サイレントなバグ」には注意が必要である。現場での運用においては、AIに直接ファイルを操作させるのではなく、コードをテキストとして出力させ、人間やスクリプトが反映する設計にすべきだ。これにより、非対話環境での自動化における確実性が向上する。生成されたコードを盲信せず、境界値テストを自動化のフローに組み込むことが、実戦投入への必須条件となる。