explain について
依頼に応じた深さで原文を説明する生産性スキルです。初学者向けから技術的な詳説まで、要点、仕組み、用語、前提知識を整理します。
主な機能
- 01ELI5、実務者向け、詳説の深さを選択
- 02仕組みを段階的に説明
- 03未定義の専門用語を用語集で解説
- 04前提知識を示し、単純化しすぎた点を指摘
活用シーン
- 01指定した深さで技術記事を理解
- 02全文の文脈を踏まえた特定箇所の説明
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ serhiikorniienko/ bullshit-detector --skill explainインストール後、Claude Code で/explainを入力して読み込まれたか確認します。
同梱ファイルVERSION
詳細
explain
内容を不正確に単純化することなく、理解しやすくします。
ワークフロー
- テキストを取得する(URL の場合は
fetch-contentスキルスクリプトを使い、それ以外の場合はウェブから取得するか、貼り付けてもらいます)。 - 説明の深さを選ぶ — ユーザーのリクエストに基づいて選ぶか、本当に不明確な場合は短い質問を 1 つだけします。
- ELI5 — たとえを使い、専門用語を使わず、中心となる仕組みだけを説明します
- 実践者向け — 一般的な技術知識を前提に、仕組みと実際にすべきことを中心に説明します
- 詳細解説 — 仕組み、例外的なケース、歴史、対立する見解を説明します
- 次の構成で説明する:
- まず一文で要約します
- 仕組み:実際にどのように動くかを順を追って説明します
- 用語集:内容で使われている、定義されていない専門用語をすべて 1 行ずつ説明します
- 内容が前提としている知識 — わかりにくさの原因となった、不足している前提知識を説明します
- 内容の説明に誤りや過度な単純化がある場合は、その箇所を指摘します。繰り返すのではなく、明示してください
ルール
- 説明することと、支持することは別です。内容の主張に異論がある場合は、その説明と異論の両方を示します(「動画では X と主張していますが、標準的な見解は Y です」)。
- たとえは、細部まで検討しても成り立つものにしてください。たとえが当てはまらない点も説明します。
- ユーザーが特定の箇所(「12:30 の部分」「セクション 3」など)を指定した場合は、その箇所を切り離さず、全体の文脈の中で説明します。
- 冗長な説明は避けます。3 文で説明できる概念は、3 文で説明します。
コメント
Markdown 対応