AIに「中学生でもわかるように1枚のHTMLで図解して」が、複雑なコードを読む前の最良の準備運動かも

はじめに 株式会社イエソドの竹内(@chimerast)です。 今回は、軽いお話しで、Claude CodeなどのAIに複雑なロジックを解説させるときの豆知識です。 きっかけは「5才児向けの絵本」だった この話の始まりは、コードとは関係のない雑談でした。 弊社のメンバーがClaudeに「Fable 5 と Fable 5.1 の違いを、5才児でもわかるように絵本風に解説して」と頼んだのです。AnthropicのThariq Shihipar氏が紹介していた「ELI5」というClaude CodeのSkillだそうです。半分は遊びだったと思います。ところが出てきた絵本が、モデルのリリースノートを読むよりずっと早く「何が変わったのか」を掴ませてくれました。 そのとき気づいたのは、読者のレベルを極端に下げる指示は、モデルに「要約」ではなく「構造の抽出」を強制するということです。5才児に専門用語は

[ardarim]

ChatGPTが流行りだした頃の生成AI初期のテクニックを思い出すな→「中学生でもわかるように説明して」

[evergreeen]

ところで、なぜAIは「効く」という言葉を乱用するのか？

[kkobayashi]

AIを使うなら分からない単語を解説してもらえばいいだけでは？専門用語を避けて抽象的な説明をされたら余計に分からなくなる（あるいは分かった気になるだけ）ような・・・

[kMGZXdG]

5歳児に〜の方は試してみたけど、やたら変な抽象化されて逆に訳分からんかった。

[D_first]

html化自体は最近よくやってみてる。しかしこの記事を見てわかるように、AI文体を直すように校正をかけないと死ぬほど読みづらいので注意。

[ustar]

リンクなしのHTML文書とはなかなか冒涜感あるな

[taruhachi]

「さるでもわかるようにして。」『ウッキー♪ウキャ！』

[kazukan]

中学生は知らんけど、.mdファイルレビューするのつらくなってくるよ。クライアント向けにはhtml変換してみせるしかないと思っていて、なんならExcelにpythonで変換して出してあげてもいいくらい。前時代的ってのはわかる

[yarumato]

“読者の知的レベルを極端に下げる指示は、モデルに「要約」ではなく「構造の抽出」を強制する。中学生には専門用語は使えません。中身を理解して、別のものにたとえるしかない。たとえが成立の時点で、構造は把握”

[toria_ezu1]

HTMLにページの長さなんてあったっけ？無限に継ぎ足せると思うんだけど／絵本風はいいかもしれない

[simplememofast]

要点は「レベルを下げる」ではなく「専門用語を封じ要約でなく構造抽出を強制する」点。だから読解が探索から確認に変わる。対応表がコードへ戻る橋になる

[natsuvien]

良い話題で言いたいことも分かるが、AI生成ワード連発で表現が全体的に気持ち悪すぎる。

[snaka72]

レビューでPRを理解するのに使えるかなー？試してみよう

[nguyen-oi]

専門用語を封じるプロンプトは構造把握にガチで効くやつ、1枚のHTMLにまとめさせる制約も天才の発想だな