00:00
使用書、報告書、PRの説明を実際に読んでもらえる可能性は、HTMLの方がずっと高い。
だいたい5回ぐらいスクロールしないと全部見切ることはできません。 AIのモデル自体が長く書くように育ってしまっているということです。
こんにちは、超実践AI論のたいちです。今回は、AIの報告を自動でHTML化して直感的に理解できるようにする、というテーマでお話しします。
AIに作業を任せると、かなり長い作業報告をしてきます。 これは、AIに作ってもらったPRですが、だいたい5回ぐらいスクロールしないと全部見切ることはできません。
AIの作業報告はマークダウンで書かれ、見出しやリンク、引用、過剰書きといった多少の文字表現はできますが、ほとんどは文字で埋まって内容が理解しづらいです。
そのため、読み飛ばしや見落として重要な点をスルーしてしまう可能性も大きいです。
クロードコードの開発者も同じ考えを持っていて、クロードの公式ブログで、100行を超えるマークダウンファイルは実際にまず読まない、社内の他の人に読ませることはなおさらできない。
使用書、報告書、PRの説明を実際に読んでもらえる可能性は、HTMLの方がずっと高いと記しています。
AIが普通の人に比べて10倍、100倍のアウトプットを出してくるようになった今は、マークダウンのAIの報告に全て目を通すのは不可能です。
実際、クロードコードが書くPRの説明欄は、人が書く場合に比べて約4倍長くなるという研究もあります。
できるだけ簡潔に可能なら一語で、といった報告を簡略化する指示を出しても、14種類のLLM×5つのデータセットで、縮めるべきところを縮めずに冗長な回答を出してきたという研究もあります。
つまり、AIのモデル自体が長く書くように育ってしまっているということです。
実際、僕の自社開発プロジェクトのPRの文字数の中央値はなんと1266文字です。
つまり、一つの作業をするたびに原稿用紙3枚以上の報告を毎回してくるということです。
それだけの報告をほとんど文字だけで、隅から隅まで目を通すのはやってられないので、最近AIの作業報告方法を変えました。
具体的には、人に対しての報告はHTMLにさせています。
実際にクロードコードがHTMLで報告した実例がこちらです。
このように場面ごとに適切な色や装飾を使って読みやすくしてくれたり、図を使って処理の流れをわかりやすくしたり、
HTMLの表現力を存分に活かして作業内容をまとめてくれています。
僕のクロードコードは作業完了時に必ずこのようにHTMLで報告するよう仕組みを作りました。
その仕組みを作るときに使った指示がこちらです。
指示内容を読み上げると、フィニッシュの最後で対応内容をHTMLで作成するようにして、
HTMLの表現力を活かし、人が見たときに理解しやすい形で対応内容をまとめる。
作業過程は不要なので、最終的に何をどう変えたかをわかるようにする。
HTMLで対応内容を説明するのは、スキル自体の修正やコード修正のみで、記事や動画などのコンテンツ作成作業では不要。
03:02
人はこのHTMLの対応を見るので、作業完了時の報告、PR説明文はAIエージェントに必要なもの以外、簡略化して良い。
これで、クロードコードの作業完了時の報告は必ずHTMLでやってくれるようになりました。
冒頭のフィニッシュというのは、AIの作業終わりにコードレビューや無駄なテストの削除をやってくれる、僕の自作スキルです。
詳しくは以前にAIコードレビュー自動化の動画を撮っているので、気になる方は概要欄のリンクから見てみてください。
そして、人はHTMLでAIの作業内容を理解するので、AIによる作業報告やPRの説明文は簡略化して、出力トークンを節約しています。
ただし、HTMLによる作業報告は、マークダウンで書いた場合の2から4倍の時間を消費します。
おそらく、トークン消費もマークダウンで書く場合に比べて多くなっていると思います。
ですが、大量の情報をほぼ文字だけのマークダウンで書かれて、重要な箇所やAIのミスを見落とすよりは、多少トークンや時間を払っても、
AIの作業を直感的に理解しやすいHTMLで報告してもらう方がコスパが良いと思います。
ここで一つお知らせです。業務のAI活用の個別サポートや研修、システム開発などのお仕事は、概要欄の公式LINEからお問い合わせください。
相談は無料です。動画の内容やその他のご質問にも公式LINEで回答しています。
ぜひあなたもAIの作業報告を実際ほとんど読み飛ばしていると思ったら、今回紹介したプロンプトを参考に、HTMLの報告を仕組み化してみてください。
ただAIに作業を丸投げするのではなく、AIの作業内容をきちんと理解して、こちらが手綱を持ちながら、AIと一緒により良い成果物が作れるようになるはずです。
概要欄にも今回の内容を解説した記事を貼っておきます。それでは今日はこの辺で。