Copilot cloud agent活用、完了条件を先に書く

AIに実装を頼むとき、「記事管理の機能を作って」のような一言で始めると、何を保存するのか、同じIDが来たらどうするのか、どこまでできれば完成なのかが決まらない。コードができたあとに判断を一から始めるのは大変だ。そこで記事候補を保存する機能を例に、依頼文へ完了条件を書き込む進め方が示されている。登録した記事を一覧で確認できる、同じIDを再登録しても既存の記事を上書きしない、必須項目が欠けていたら理由を表示して保存を中止する、不正なIDでも同様に中止する、といった確認項目を先に並べる。正常な登録だけでなく、重複IDや入力不備のときに保存を止められたかまで確かめる点が要点だ。

今回だけの要件は依頼文に、繰り返し使うルールはリポジトリに置く。VS CodeにはMarkdownの指示ファイルに共通の開発方針を保存する仕組みがあるが、選んだエージェントによって対応する形式や読み込み方は違う。また、AIに指示ファイルを作らせた場合も中身を一度読み直し、まだ用意していないテストの実行方法が書かれていないか、以前の構成のまま間違った場所にファイルを作るよう指示していないかを実際のリポジトリと見比べて直す。

指示ファイルを置いた後の確認も求められる。ファイルが見つかったことと、作業で指示が守られたことは別であり、小さな変更を一つ頼んで結果を比べる。指示が読み込まれているのに結果が合わないなら、ルールを増やす前にどこで食い違ったかを確かめる。この進め方が定着するかは、依頼文と指示ファイルを実際の変更と照合する手間をどこまで続けられるかにかかっているとみられる。