専門用語を非エンジニア向けに分かりやすく解説

技術用語を「分かりやすく説明して」と頼むと、返ってきた文章の中に別の専門用語が含まれていることがよくあります。「APIとはサーバーとクライアントがデータをやり取りするためのインターフェースです」といった具合です。AIにとって「分かりやすく」という言葉には明確な基準がないため、誰に向けて、どの程度噛み砕くべきかを人間側が指定する必要があります。

役割として「聞き手が理解できないのは説明する側の責任」と考えるスピーカーを設定したのは、文章のハードルを徹底的に下げるためです。この1行があるかないかで、同じ概念の説明でも使われる語彙が目に見えて変わります。

聞き手を具体的に指定するのは、たとえ話の材料が聞き手の属性から生まれるからです。営業部には契約や見積もりで、中学生には学校生活やゲームに例えなければ響きません。「自分たちの仕事にどう関係するのか」をあらかじめ指示に組み込んだのも同様の理由で、この一文があることで単なる用語解説ではなく、その場に即した実用的な説明が生成されます。また、形式として長さを指定することも重要です。エレベーターピッチとスライド1枚では求められる文章構成が全く異なります。

概念をたとえ話で説明するのは一発で完璧なものを出すのが難しいため、3案を出させて選び、推敲するアプローチが適しています。たとえ話には相性があり、1つ目がしっくりこなくても2つ目がピッタリはまることがよくあります。気に入った案を選んで「この方向性でさらに調整して」と進められます。制約として「実際とのズレ」を書かせているのは安全装置です。たとえ話には必ずどこかに限界（実際の技術との違い）があり、それを理解しないまま使うと聞き手が誤解したまま次の会議に進んでしまいます。また、想定質問3つを事前に用意しておくことで、本番の質疑応答で慌てる心配も減らせます。

ほぼ毎回「レストランのウェイター」のたとえ話が出現し、本文には「クライアント」「リクエスト」「レスポンス」といった専門用語がそのまま残りがちです。聞き手が定まっていないため実務との結びつきが抜け落ち、文章の長さも指定がないためそのまま実際の会話や資料で使うことができません。