こういう主張を見るたびに思うのだが、バカが書いたトンチキドキュメントの方がよっぽど有害では？
ま、生成AIの文章作成能力なんて、あっという間に改善されてくと思うけどねぇ。あとは使い手の指示しだいになるんじゃないの？
AIの「とりあえず全部書いとけ」感は異常。プロンプトで削ぎ落とすのは基本だけど、人間が読むための要約に人間が苦労する本末転倒感
最近、AIのチャット文がすごい上手くなってる感じする。響くワンフレーズというか決めゼリフ的なキャッチ作るのがこなれてきてる
今日ちゃんと「人間は文字を読むのが嫌い」とわからせといたよ。
長い文書を読むときは「なんて書いてあるか要約して」「AAはBBってこと？」「XXがよくわからないから説明して」みたいな感じで、最近は頭から読んでない
やらない事明記スコープ外一般論禁 結論を先に詳細は結論を補強する形で後ろ 用語定義や背景説明等定型セクションは必要な場合だけ 代替案の比較は表、両論併記禁 その章なしでレビュアが意思決定理解できるなら削除
分かる。生成AIは瑣末な経緯をダラダラ書きがちで、いつも「ドキュメントはお前の日記じゃねえよ」とフィードバックしてる／一度ダラダラ書く理由を問い質したら「ブログ記事等で学習してるもんで」と言い訳してきた
すでにもうそうなっているがドキュメントを読むのはAIで人間はAIの要約あるいはすでに判断された結果を聞くだけ。誰もドキュメントなんか読まない世界
長い内容をざっと読んで気になるところだけ答えてるとAIがイライラするかのように「（再掲）回答が必要なもの」のように太字で出してくる。
斜め読みして「オイこれちがくねぇか」と喧嘩腰の応酬をするのも疲れてきました。怒るのも疲弊するのよ…
俺は誰が書いたかは気にせず内容の良し悪しで判断したい
特に指示しなければ冗長な文が出てきやすいよねえ。できるだけ矯正はさせるけど。
この記事は人間が読めるドキュメントにする方向だけど、ワイはエージェントが読むようにして、ワイが読むときはAIに要約させてる。人間向けドキュメントだと情報量制約がでて後々エージェントが困りそうで
"Design docの書き方を指定したSkillで作らせたAfter"
然し,ブコメ生成Aiはchanと要点のみかけておる
長い説明には要約と一覧の後に詳細を。メリットデメリットだけでなく、適した利用ケース。特に利用ケースを提示するのは、結構効果的で、読者がイメージを膨らませやすい
せめて一度は読んでから出せと言いたくなるヤツはいる(ノ∀`)何も考えてない証明でしかなくて失礼だからむしろ出すなみたいな
ドキュメントなんて読まない。AIで、必要な部分のみ拾ってきてくれればそれで良い。後はそこをAIで要約させるなり、解説させるなり、お好きなように
最近聞いた意見だと、設計者の成長のためにレビューするやる気があったけどそれが無くなったっていう意見があった。なるほどなと思う。
「疲れる理由は、次の4つに集約される」←これを避けるように指示できないのだろうか、と思ったら、そういう話だった。まあ使う機会はないだろうし、生成AIの出力をレビューする気はないが。
短く書いて認知負荷さげるルールにしてる
『あの独特の』：つい、ふふふ(笑)。；『この記事の読者であれば説明なしでも読めると判断したためです』：それを言外に求めてることが分かったっていう壁打ちだったってことではないでしょうか。
ちゃんと人に分かりやすい図を作ってくれれば良いのだけど。文字だけは駄目。全体像分かる図と抽象度から入って、その後詳細。要約させてもAIはどうも重要度が微妙にズレている
「抽象度上げろ」でおｋ
人間にだってそんぐらいの指示はしないとダラダラ文章書いてくるけどね
AI生成物は、とにかく「意図」がぼやけて頭に入って来ない印象がある。「お前は誰だ？」と聞きたくなる。
そうか、まだ「読みやすさ」であったり、「単純化」「比喩」「婉曲表現」とかは足りて無いんだな。でも、そのうち追い越すんで無いの？それにマニュアルは、そういうモノと割りきるしか無いんじゃね？
まとめてと言うとAIは抽象度を一段上げた上に無難な表現にするから読みにくくなる。まとめる前は具体的でわかりやすいのに
結論を最後にだけ書くのは英語のエッセイではよくあるスタイルなので、人間もやってる。読みにくいなと思いながら、最後のパラグラフから読む。スタイルなので、AI が進化しても直らないと思う。
AIに文書を書かせて。AIにその文書を要約させて。それで何を伝えたんだ？何を理解したんだ？頭おかしいの？
もうすでに記事の全文は人間が読むものじゃなくなってるのよ。
仕事で行き交う文章なんて、どうせお互い義務感で書いてるんだから要約で十分という考え方はあるかもしれない。実用書もそれでいい。だけど本来、楽しみのために書いたり読んだりする文章ではやめてほしい。醜悪。
自分の書いた文を大量に読ませて、「自分の書き方.md」みたいなのを作らせ、それを参照に文を作らせると自分とAIの中間みたいな文章になる
たまたま見えた小さな癖を生成AIがと大きく書いてるのは分かってないのかわざとなのか
広く公開されるようなドキュメントはfableなり使って品質よくしてほしい。タスクの難しさじゃなくて文章能力のために。生成AIは進化するだろうけど、今現在の問題なので…この品質で問題ないと判断してる情シスも問題
生成AI使いすぎて長い文章を読む能力が衰えてるんだと思う
もともとだれもドキュメント読んでなかった問題 / 今北三行って言うと端的にまとめてくれる
いまだにそんなこと言ってるやついるんだ。作り方が下手なんだよ
この文章自体をこのスキルで書いてるんだと思うが、まだ読みにくいと感じる。コードと同じく「動けばいい」ドキュメントも多いんだけど、大人数に読ませるドキュメントと大規模PJの基盤コードはAIには当分無理では。
まぁ、仕事のドキュメントに関しては、どうせ誰も読まないだろうし、AI に書かせても良いと思うけど、ブログを AI に書かせる人って、「それ、楽しいの？」と思う事はある。
今のところ、生成AIの日本語文章は情報量自体は少ない（たとえば時制が内容に対して適切でないのでただの文字埋めになっている）というのは感じる。他の非英語でもそうっぽい。大量だけど読み取れる情報が少ない。
人間用とAI用は分けないと無理だよね。分量の多いAI用から、都度人間用のスナップショットとしてスライド化してるけど、無駄にトークン減らしてる感じなので、元のAI用もスリム化は必要だな。参考にさせてもらいます。
人間に対してだと濃淡付けが重要だけど、AIに読ませる文章だと省略されると困る事もあったりするので悩ましい
生成AIが書いたドキュメントを読みたくない - Qiita
こういう主張を見るたびに思うのだが、バカが書いたトンチキドキュメントの方がよっぽど有害では？
ま、生成AIの文章作成能力なんて、あっという間に改善されてくと思うけどねぇ。あとは使い手の指示しだいになるんじゃないの？
AIの「とりあえず全部書いとけ」感は異常。プロンプトで削ぎ落とすのは基本だけど、人間が読むための要約に人間が苦労する本末転倒感
最近、AIのチャット文がすごい上手くなってる感じする。響くワンフレーズというか決めゼリフ的なキャッチ作るのがこなれてきてる
今日ちゃんと「人間は文字を読むのが嫌い」とわからせといたよ。
長い文書を読むときは「なんて書いてあるか要約して」「AAはBBってこと？」「XXがよくわからないから説明して」みたいな感じで、最近は頭から読んでない
やらない事明記スコープ外一般論禁 結論を先に詳細は結論を補強する形で後ろ 用語定義や背景説明等定型セクションは必要な場合だけ 代替案の比較は表、両論併記禁 その章なしでレビュアが意思決定理解できるなら削除
分かる。生成AIは瑣末な経緯をダラダラ書きがちで、いつも「ドキュメントはお前の日記じゃねえよ」とフィードバックしてる／一度ダラダラ書く理由を問い質したら「ブログ記事等で学習してるもんで」と言い訳してきた
すでにもうそうなっているがドキュメントを読むのはAIで人間はAIの要約あるいはすでに判断された結果を聞くだけ。誰もドキュメントなんか読まない世界
長い内容をざっと読んで気になるところだけ答えてるとAIがイライラするかのように「（再掲）回答が必要なもの」のように太字で出してくる。
斜め読みして「オイこれちがくねぇか」と喧嘩腰の応酬をするのも疲れてきました。怒るのも疲弊するのよ…
俺は誰が書いたかは気にせず内容の良し悪しで判断したい
特に指示しなければ冗長な文が出てきやすいよねえ。できるだけ矯正はさせるけど。
この記事は人間が読めるドキュメントにする方向だけど、ワイはエージェントが読むようにして、ワイが読むときはAIに要約させてる。人間向けドキュメントだと情報量制約がでて後々エージェントが困りそうで
"Design docの書き方を指定したSkillで作らせたAfter"
然し,ブコメ生成Aiはchanと要点のみかけておる
長い説明には要約と一覧の後に詳細を。メリットデメリットだけでなく、適した利用ケース。特に利用ケースを提示するのは、結構効果的で、読者がイメージを膨らませやすい
せめて一度は読んでから出せと言いたくなるヤツはいる(ノ∀`)何も考えてない証明でしかなくて失礼だからむしろ出すなみたいな
ドキュメントなんて読まない。AIで、必要な部分のみ拾ってきてくれればそれで良い。後はそこをAIで要約させるなり、解説させるなり、お好きなように
最近聞いた意見だと、設計者の成長のためにレビューするやる気があったけどそれが無くなったっていう意見があった。なるほどなと思う。
「疲れる理由は、次の4つに集約される」←これを避けるように指示できないのだろうか、と思ったら、そういう話だった。まあ使う機会はないだろうし、生成AIの出力をレビューする気はないが。
短く書いて認知負荷さげるルールにしてる
『あの独特の』：つい、ふふふ(笑)。；『この記事の読者であれば説明なしでも読めると判断したためです』：それを言外に求めてることが分かったっていう壁打ちだったってことではないでしょうか。
ちゃんと人に分かりやすい図を作ってくれれば良いのだけど。文字だけは駄目。全体像分かる図と抽象度から入って、その後詳細。要約させてもAIはどうも重要度が微妙にズレている
「抽象度上げろ」でおｋ
人間にだってそんぐらいの指示はしないとダラダラ文章書いてくるけどね
AI生成物は、とにかく「意図」がぼやけて頭に入って来ない印象がある。「お前は誰だ？」と聞きたくなる。
そうか、まだ「読みやすさ」であったり、「単純化」「比喩」「婉曲表現」とかは足りて無いんだな。でも、そのうち追い越すんで無いの？それにマニュアルは、そういうモノと割りきるしか無いんじゃね？
まとめてと言うとAIは抽象度を一段上げた上に無難な表現にするから読みにくくなる。まとめる前は具体的でわかりやすいのに
結論を最後にだけ書くのは英語のエッセイではよくあるスタイルなので、人間もやってる。読みにくいなと思いながら、最後のパラグラフから読む。スタイルなので、AI が進化しても直らないと思う。
AIに文書を書かせて。AIにその文書を要約させて。それで何を伝えたんだ？何を理解したんだ？頭おかしいの？
もうすでに記事の全文は人間が読むものじゃなくなってるのよ。
仕事で行き交う文章なんて、どうせお互い義務感で書いてるんだから要約で十分という考え方はあるかもしれない。実用書もそれでいい。だけど本来、楽しみのために書いたり読んだりする文章ではやめてほしい。醜悪。
自分の書いた文を大量に読ませて、「自分の書き方.md」みたいなのを作らせ、それを参照に文を作らせると自分とAIの中間みたいな文章になる
たまたま見えた小さな癖を生成AIがと大きく書いてるのは分かってないのかわざとなのか
広く公開されるようなドキュメントはfableなり使って品質よくしてほしい。タスクの難しさじゃなくて文章能力のために。生成AIは進化するだろうけど、今現在の問題なので…この品質で問題ないと判断してる情シスも問題
生成AI使いすぎて長い文章を読む能力が衰えてるんだと思う
もともとだれもドキュメント読んでなかった問題 / 今北三行って言うと端的にまとめてくれる
いまだにそんなこと言ってるやついるんだ。作り方が下手なんだよ
この文章自体をこのスキルで書いてるんだと思うが、まだ読みにくいと感じる。コードと同じく「動けばいい」ドキュメントも多いんだけど、大人数に読ませるドキュメントと大規模PJの基盤コードはAIには当分無理では。
まぁ、仕事のドキュメントに関しては、どうせ誰も読まないだろうし、AI に書かせても良いと思うけど、ブログを AI に書かせる人って、「それ、楽しいの？」と思う事はある。
今のところ、生成AIの日本語文章は情報量自体は少ない（たとえば時制が内容に対して適切でないのでただの文字埋めになっている）というのは感じる。他の非英語でもそうっぽい。大量だけど読み取れる情報が少ない。
人間用とAI用は分けないと無理だよね。分量の多いAI用から、都度人間用のスナップショットとしてスライド化してるけど、無駄にトークン減らしてる感じなので、元のAI用もスリム化は必要だな。参考にさせてもらいます。
人間に対してだと濃淡付けが重要だけど、AIに読ませる文章だと省略されると困る事もあったりするので悩ましい