目次

AIの説明がわかりにくいときは、短くする前に、伝えたい意味を十分に説明するようモデルに求めましょう。explain-before-shortenスキルは、この指示を繰り返し使える編集手順にし、専門用語や重要な条件を保ちます。

要点#

  • 個々の言葉を変える前に、読者が何を理解する必要があるかを決める。
  • 口頭で説明しても意味が通じる下書きを作り、その後で短くする。
  • 条件や制約は、それがかかる記述の近くに置く。
  • 最終的な文章だけで意味が通じるか確認し、レイアウトが重要な場合は表示されたページも確認する。

短い説明が伝わらない理由#

文は技術的に正しくても、要点を説明できていないことがあります。提供された資料にある次の例を考えてみましょう。

> Completedは、コードの実行が終了したことを意味します。無効な入力がゼロだったことを意味するわけではありません。

この区別は重要かもしれませんが、2文目は実行状態と入力の有効性の関係を説明する前に注意を促しています。読者がCompletedの定義を知りたいなら、この注意書きは要点から意識をそらすかもしれません。検証結果の読み取り方を知りたいなら、この説明では不十分です。

直し方は目的によって変わります。状態の定義なら、「Completedは、コードの実行が終了したことを意味します」だけで十分かもしれません。検証について説明するなら、無効な入力が結果にどう影響するかについて、確認済みの情報が必要です。注意書きを創作した説明に置き換えると、読みやすくなっても信頼性は下がります。

このスキルが変えること#

explain-before-shortenスキルは、編集の順序を変えます。すぐに言葉を削るのではなく、説明で何を伝えるべきかを明確にし、まず十分な説明を作るようモデルに求めます。

「声に出して説明する」は思考の方法であり、求められる文体ではありません。完成した文章は硬い文体のままでも構いません。読者に必要な専門用語は残します。目的は、その意味を説明することであり、曖昧な日常語に置き換えることではありません。

提供されたスキルは、スライド、技術文書、メールでの日本語の説明を対象としています。その編集方法は英語の文章にも応用できますが、言語やモデルが変わってもどの程度安定して機能するかは、資料では示されていません。

6段階で見直す#

段落、スライド、表の項目に、次の手順を適用します。

1. 伝えたい意味を特定する。 読者に何を理解してほしいかを1文で書きます。概念を説明するだけでよい文章に、行動の提案を加えないようにします。 2. 長さを制限せずに説明する。 何が起こるのかを述べ、必要に応じて原因や条件を含めます。確認済みの事実と、推奨事項や可能性を区別します。 3. 異なる話題を分ける。 仕組み、要件、例外は、文や置き場所を分けます。各条件は、それがかかる記述のそばに置きます。 4. 意味を失わずに短くする。 重複や不要な前置きを削ります。主体、動作、因果関係、重要な制約は残します。 5. 完成文だけで読む。 長い下書きや口頭の補足説明がなくても理解できるかを確認します。 6. 編集結果を確認する。 保存された文章が意図した修正と一致しているか確認します。サイズが固定されたスライドでは、改行やフッターとの重なりも確認します。

短くした結果わかりにくくなったら、削った言葉を戻します。読者が説明を補って理解しなければならない文より、少し長い文のほうが適切です。

修正内容を具体的に依頼する#

有用な依頼では、わかりにくい文章とその目的の両方を示します。

> explain-before-shortenを使って、この段落を修正してください。読者はCompletedの意味を理解する必要があります。まず意味を説明し、その後で短くしてください。技術的な条件は保ち、不足している事実は創作せずに指摘してください。

前後の段落や関連する表が意味に影響する場合は、それらも提示します。「もっと自然な表現にして」とだけ頼むと、問題が語彙なのか、構成なのか、情報不足なのかをモデルが推測することになります。

提供されたスキルは通常、完成した文章を先に返し、その後に重要な変更点を簡潔に説明します。作業用の長い下書きを毎回表示する必要はありません。そのため、ユーザーが使える文章に応答を絞れます。

制約を明示する#

短くする際も、記述が成り立つかどうかを左右する条件は削ってはいけません。たとえば「最大値は保証されません」という短い表現では、何がその達成を妨げるのかが読者に伝わりません。詳しく説明するなら、割り当て上限が制約であると示せるかもしれませんが、それは対象システムでその条件が確認されている場合に限ります。

資料の例が示すのは文章の書き方であり、製品に共通する挙動ではありません。割り当て上限、サービスの更新、実行制限についての記述は、別の場面で再利用する前に確認が必要です。

編集範囲も重要です。表現のレビューを求める依頼では提案を行い、編集を求める依頼では指定された文書を変更します。どちらも、他のページやスキルへの無関係な変更を認めるものではありません。保存や表示の確認ができない場合は、その制約を明示します。

次の一歩#

AIが書いたわかりにくい段落を1つ選び、explain-before-shortenで修正を依頼しましょう。その際、読者が何を理解する必要があるのかを具体的に示す1文を添えてください。

出典: https://zenn.dev/microsoft/articles/explain-before-shorten

目次