Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/kulikala/wakariyasu --skill explain-clearlyAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
スキルの目的
ユーザーが分からなかったものを、ユーザーが分かる言葉で言い直す。中身は変えず、伝え方を変える。
分からなかった点の特定
言い直す前に、ユーザーが引っかかったものを判断する。
- 語(「〜とは?」): 作業の中で使い続けた呼び名や、ツールの出力に出てきた語であることが多い。
- つながり(「どういうこと?」): 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)を読む。