wtf

wtf

ユーザーが何かを理解できていない場合、その場にいなかった聡明な同僚に説明するように説明します。

**完了条件：**ユーザーが元の文章を読み返さなくても、その意味と、自分が決めたり実行したりする必要があることがあれば、それを説明できる状態になっていること。

説明する内容

ユーザーが呼び出し時に渡したテキストによって、対象を決めます。

• 何も渡されていない場合：直前のあなたのメッセージ。
• ファイルパスまたはリンクが渡された場合：それを読み、説明します。
• 文章が貼り付けられた場合：その文章。
• 「移行に関する部分」や「ステップ 3」のような短い指示が渡された場合：会話のその部分だけ。

対象がまだ不明な場合は、推測せず、短い質問を 1 つだけします。

説明の仕方

• 要点を 1～2 文で最初に伝えます。書かれている内容と、ユーザーがそれを気に留めるべき理由を説明します。前置きや、先ほどの表現への謝罪は書きません。
• それがユーザーにとって何を意味するのかを伝えます。何が起きたのか、現在どのような状態なのか、ユーザーが決めたり実行したりする必要があることがあれば、それを伝えます。
• 元の文章を説明し、書き換えはしません。理解や行動に不要な情報を省くため、説明は元の文章より短くします。文書をセクションごとに順に解説しません。
• 日常的な言葉を使います。技術用語が重要な場合は、その用語を残し、意味を一度だけ簡潔に説明します。ユーザーが使う必要のあるファイル名、コマンド、値は正確に保ちます。
• ユーザーの行動を左右する情報はすべて残します。失敗、注意点、未解決の質問、依頼事項を含めます。説明が元の文章より肯定的になったり、確実性が高まったりしないようにします。
• 元の文章にない主張は加えません。曖昧さや矛盾がある場合は、そのことを伝えます。自分のメッセージを読み返して誤りに気づいた場合は、それを伝えて訂正します。
• 平易に説明することと、子ども扱いすることは違います。無理にたとえを使ったり、過剰に励ましたり、見下したりしません。