生成AIが書いたドキュメントを読みたくない - Qiita

株式会社ブレインパッドプロダクト開発部でRtoaster GenAIの開発をしている依田です。 Claude CodeにDesign docやPRを書かせていて、「情報量は多いのに、何を決めたのかがなかなか頭に入ってこない」と感じたことはないでしょうか。私は何度もあります。読んでいるあいだずっと気を張っていないと、一番知りたい結論を読み落としてしまう。あの独特の疲労感の正体を、実際のGitHub PRを使って確かめてみました。 対象読者 Claude CodeなどのAIエージェントに設計書やPRを書かせている方 Skillやプロンプトの設計を見直したい方 生成AIが書いたドキュメントのレビューに疲れた経験がある方 なぜAIの文章を読むと疲れるのか 内容が間違っているわけではありません。むしろ大抵は正しいことが書いてあります。それでも疲れる理由は、次の4つに集約されると考えています。 網羅と

[l1o0]

長い文書を読むときは「なんて書いてあるか要約して」「AAはBBってこと？」「XXがよくわからないから説明して」みたいな感じで、最近は頭から読んでない

[ackey1973]

ま、生成AIの文章作成能力なんて、あっという間に改善されてくと思うけどねぇ。あとは使い手の指示しだいになるんじゃないの？

[mr_mayama]

俺は誰が書いたかは気にせず内容の良し悪しで判断したい

[morimarii]

すでにもうそうなっているがドキュメントを読むのはAIで人間はAIの要約あるいはすでに判断された結果を聞くだけ。誰もドキュメントなんか読まない世界

[dagama]

人間にだってそんぐらいの指示はしないとダラダラ文章書いてくるけどね

[rawwell]

もともとだれもドキュメント読んでなかった問題 / 今北三行って言うと端的にまとめてくれる

[awaytabi]

この記事は人間が読めるドキュメントにする方向だけど、ワイはエージェントが読むようにして、ワイが読むときはAIに要約させてる。人間向けドキュメントだと情報量制約がでて後々エージェントが困りそうで

[ejointjp]

もうすでに記事の全文は人間が読むものじゃなくなってるのよ。

[JULY]

まぁ、仕事のドキュメントに関しては、どうせ誰も読まないだろうし、AI に書かせても良いと思うけど、ブログを AI に書かせる人って、「それ、楽しいの？」と思う事はある。

[circled]

自分の書いた文を大量に読ませて、「自分の書き方.md」みたいなのを作らせ、それを参照に文を作らせると自分とAIの中間みたいな文章になる

[ginpei]

重要度を勘案せず自明な点も省略しない、結論が最後に来る、といった特徴。例示のスキルで書き方を指示すると改善したという。人力で記述口述する場合でも参考にできそう。

[misshiki]

生成AIのDesign docが読みにくい原因を実験。結論先出し・Non-goals・不要章の削除・代替案の表形式化をSkillに追加すると、同一実装で8,521→1,239文字に。AIには「何を書くか」だけでなく「何を書かないか」も指定する。

[yarumato]

“生成AIの文章を読むと疲れる理由は、重要度を選別せず・結論を後回しにし・型を律儀に埋め・自明な項目にも両論併記するという4つの癖にある。Skillにこの対処を明示するだけで、Design docの分量は7分の1”

[secseek]

こういうの見るとレベルが高くてうらやましいとしか思えません。Excelでドキュメントを書くせいで横スクロールしないと読めないなんて悩んでるレベルからすると、こんなのぜいたくとしか思えないですね

[dalmacija]

生成AIが書いたドキュメントだから読みたくないわけではない、という記事だった

[ite]

わかる。人間向けのまとめを書くべき。

[airj12]

人間に対してだと濃淡付けが重要だけど、AIに読ませる文章だと省略されると困る事もあったりするので悩ましい

[yonao205]

人間用とAI用は分けないと無理だよね。分量の多いAI用から、都度人間用のスナップショットとしてスライド化してるけど、無駄にトークン減らしてる感じなので、元のAI用もスリム化は必要だな。参考にさせてもらいます。

[ntfs]

今のところ、生成AIの日本語文章は情報量自体は少ない（たとえば時制が内容に対して適切でないのでただの文字埋めになっている）というのは感じる。他の非英語でもそうっぽい。大量だけど読み取れる情報が少ない。

[otoku-memo]

この文章自体をこのスキルで書いてるんだと思うが、まだ読みにくいと感じる。コードと同じく「動けばいい」ドキュメントも多いんだけど、大人数に読ませるドキュメントと大規模PJの基盤コードはAIには当分無理では。

[mayumayu_nimolove]

いまだにそんなこと言ってるやついるんだ。作り方が下手なんだよ

[KullbackLeibler]

生成AI使いすぎて長い文章を読む能力が衰えてるんだと思う

[bilanciaa]

広く公開されるようなドキュメントはfableなり使って品質よくしてほしい。タスクの難しさじゃなくて文章能力のために。生成AIは進化するだろうけど、今現在の問題なので…この品質で問題ないと判断してる情シスも問題

[harumomo2006]

たまたま見えた小さな癖を生成AIがと大きく書いてるのは分かってないのかわざとなのか

[duckt]

仕事で行き交う文章なんて、どうせお互い義務感で書いてるんだから要約で十分という考え方はあるかもしれない。実用書もそれでいい。だけど本来、楽しみのために書いたり読んだりする文章ではやめてほしい。醜悪。

[hanninyasu]

AIに文書を書かせて。AIにその文書を要約させて。それで何を伝えたんだ？何を理解したんだ？頭おかしいの？

[tybalt]

結論を最後にだけ書くのは英語のエッセイではよくあるスタイルなので、人間もやってる。読みにくいなと思いながら、最後のパラグラフから読む。スタイルなので、AI が進化しても直らないと思う。

[Kukri]

まとめてと言うとAIは抽象度を一段上げた上に無難な表現にするから読みにくくなる。まとめる前は具体的でわかりやすいのに

[inks]

そうか、まだ「読みやすさ」であったり、「単純化」「比喩」「婉曲表現」とかは足りて無いんだな。でも、そのうち追い越すんで無いの？それにマニュアルは、そういうモノと割りきるしか無いんじゃね？

[omega314]

AI生成物は、とにかく「意図」がぼやけて頭に入って来ない印象がある。「お前は誰だ？」と聞きたくなる。

[jintrick]

「抽象度上げろ」でおｋ

[narukami]

読める状態にするため指定しなきゃならないことが多すぎる

[qpci32siekqd]

ちゃんと人に分かりやすい図を作ってくれれば良いのだけど。文字だけは駄目。全体像分かる図と抽象度から入って、その後詳細。要約させてもAIはどうも重要度が微妙にズレている

[gcyn]

『あの独特の』：つい、ふふふ(笑)。；『この記事の読者であれば説明なしでも読めると判断したためです』：それを言外に求めてることが分かったっていう壁打ちだったってことではないでしょうか。

[chiba1008]

短く書いて認知負荷さげるルールにしてる