AIに作業を頼む前に、チケットに書いておくこと
結論(先に要点)
AIに作業を頼んで手戻りが多いとき、原因はAIの性能よりも、依頼側の情報不足であることが多いです。 チケットに「目的」「前提」「やってはいけないこと」「完了の基準」の4点を書いておくだけで、AIの成果物の当たり外れはかなり減ります。
対象読者と前提
- 対象読者: ChatGPTやKiroなどのAIに、調査・作成・実装を頼み始めた人
- 前提: チケットでタスクを管理する進め方(Redmine、Backlog、GitHub Issuesなど、道具は問わない)
なぜ「頼み方」で結果が変わるのか
AIは、渡された情報をもとに作業します。目的が書かれていなければ無難な成果物になり、前提が書かれていなければ既存のやり方と違う進め方を選び、完了の基準がなければ「どこまでやれば終わりか」を推測で決めることになります。 人へ依頼するときと同じで、情報が足りない分だけ推測が増え、推測が増える分だけ手戻りが増えます。
チケットに書いておく4点
| 項目 | 書くこと | 書かないと起きやすいこと |
|---|---|---|
| 目的 | 何のためにやるのか、誰が使うのか | 目的に合わない成果物になる |
| 前提 | 対象範囲、使う道具、既存の資料やルール | 既存の進め方とずれた作業になる |
| やってはいけないこと | 変更してはいけない範囲、機密や個人情報の扱い | やりすぎ、または情報の扱いの事故 |
| 完了の基準 | 何ができたら終わりか、確認方法 | 終わりが見えず、確認の観点も定まらない |
目的の書き方(例)
- 悪い例:「集計を自動化して」
- 良い例:「毎週月曜に行っている売上集計(約30分)を、確認作業だけにしたい。使うのは経理担当で、Excelの操作に慣れていない人も含む」
目的に「誰が使うか」が入ると、成果物の難易度や説明の詳しさが変わります。
完了の基準の書き方(例)
- 「集計結果が、先週の手作業の結果と一致すること」
- 「テストを○件実行し、全件OKであること」
- 「変更したファイルの一覧と、変更理由がチケットに残っていること」
確認方法まで書いておくと、AI側も作業中に自分で確かめながら進められます。
私自身、AI支援開発を始めたころは、チケットに「○○を作って」と要点だけ書いて渡すことがありました。すると、既存の進め方と違う形の成果物が返ってきて、確認とやり直しに思ったより時間がかかりました。今は、目的と完了の基準を先に書いてから頼むようにしています。
書きすぎなくてよい理由
4点を毎回長く書く必要はありません。定型の項目をチケットのテンプレートに入れておけば、1件あたり数行で済みます。 むしろ大切なのは、項目を空欄のまま依頼しないことです。分からない項目は「未定」と書いておくだけでも、AIが勝手に決めて進めることを防げます。
向いている人 / 向いていない人
- 向いている人: AIへの依頼を繰り返し行う人、複数人でAIを使うチーム
- 向いていない人: その場限りの短い質問で完結する使い方をしている人(その場合は不要)
まとめ
- 手戻りの多くは、AIの性能ではなく依頼側の情報不足から生まれる
- チケットに「目的」「前提」「やってはいけないこと」「完了の基準」を書く
- 定型化すれば1件数行で済む。空欄より「未定」と書く方がよい
次回は、このチケットをもとにAIが出した成果物を人が確認するチェックリストを紹介します。
出典
- なし(本記事は進め方の考え方をまとめたもの。具体的なツール仕様は扱っていない)