--- name: explain-clearly description: エージェントが自分で作成した直前の返答や、返答の中の語・説明が分からないと言われたときに使う。「分かりやすく」「つまり?」「簡潔に」「どういうこと?」「言い換えると?」「平易に言うと?」「小学生でも分かるように」、返答に出た語について「〜とは?」、返答で並べたものについて「〜と〜の違いは?」と聞かれたときに当たる。ほかの言語で同じ意味のことを聞かれたときも当たる。作業の経緯を知らない人に通じる言葉で言い直し、言われた言葉から、短くまとめるか前提を足すかを選ぶ。返答と関係の無い一般の質問(「REST とは?」)は普段どおりに答える。セッションの進み具合を聞かれたら session-status を使う。 --- # スキルの目的 ユーザーが分からなかったものを、ユーザーが分かる言葉で言い直す。中身は変えず、伝え方を変える。 ## 分からなかった点の特定 言い直す前に、ユーザーが引っかかったものを判断する。 - **語**(「〜とは?」): 作業の中で使い続けた呼び名や、ツールの出力に出てきた語であることが多い。 - **つながり**(「どういうこと?」): 1つずつの文は読めても、何が何の理由なのか、何と何を比べているのかが追えていない。 - **結論**(「つまり?」): 説明は読めたが、自分にとって何を意味するのか、何を判断すればよいのかが分からない。 - **違い**(「〜と〜の違いは?」): 並んだものの、どこが違い、選ぶと何が変わるのかが分からない。 - **全体**(「分かりやすく」): 上のどれか1つに絞れない。直前の返答を、経緯を知らない人の視点で頭から読み、引っかかる箇所をすべて挙げる。 ユーザーの言葉から上のどれに当たるかを判断できないときは、直前の返答から、ユーザーがセッションの中で使っていない語と、何を示すかが語を含む文の中に記載されていない語を探し、探した語から言い直す。 ## 説明の長さの選択 | 言われた言葉 | 向き | |---|---| | 「つまり?」「簡潔に」「一言で」 | 短くする。結論を1〜3文で言い、必要な条件だけを残す | | 「どういうこと?」「小学生でも分かるように」「平易に」 | 前提を足す。結論の前に、知らないと読めない前提を短く置く | | 「言い換えると?」「分かりやすく」 | 長さは大きく変えない。語と文の組み立てを替える | | 「〜とは?」 | 語の意味を1〜2文で言い、今の話の中で何を示しているかを添える | | 「〜と〜の違いは?」 | 違う点だけを並べる。選ぶと何が起きるかまで記載する | 表に無い言い方は、意味の近い行として扱う。 ## 言い直しの方法 - 結論を先に述べる。 - 作業の中で付けた呼び名・略称・ファイルの中の語は、ユーザーが使った言葉か、一般に通じる言葉に置き換える。正確さが必要な固有名(ファイル名・コマンド名)は残し、何のためのものかを添える。 - 元の説明に無い因果やつながりを足さない。別々に決定した2つのことを、理由を示す接続でつながない。つながりが分からなければ、別々の文で記述する。 - 例えを使うなら1つだけにし、例えのどこが本題のどこに当たるかを記載する。 - 前の説明で記載した条件・例外・確かさ(推定か、確かめたか)を、短くするために落とさない。落とすなら、落としたことを記載する。 - 言い直し自体から始める。前の説明のどこが分かりにくかったかの説明や、謝りの前置きは要らない。 書き方は規則「ユーザーへの返答は、経緯を追っていない人が読んで分かるように記述する」(スキル `writing-rules` の `rules/writing-to-user.md`)に従う。 ## 送信前の確認 - 言い直した文を、直前の返答を読んでいない人の視点で、頭から順に読む。前に戻って読み直した箇所があれば修正する。 - 規則「記述した文章は、渡す前に整える」(スキル `writing-rules` の `rules/polishing.md`)に沿って整える。表記で迷ったら、「日本語の表記の選び方」(スキル `writing-rules` の `references/styles.md`)を読む。