关于 explaining
用于组织清晰讲解的技能,适合教学、入职引导和概念沟通。它区分介绍事物与辅助决策的讲解,并据此选择结构、深度和辅助技巧。
主要功能
- 01区分主题型与情境型请求
- 02采用三阶段讲解结构
- 03按三种深度调整内容
- 04按需使用示例与类比
- 05提供清单和完整示例
适用场景
- 01讲解概念或流程的运作方式
- 02帮助受众在不同方案间决策
- 03准备入职引导或教学材料
- 04困惑时重新梳理理解框架
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alexanderstephenthompson/ claude-hub --skill explaining安装后在 Claude Code 中输入/explaining确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/depth-comparison.mdexplanation-checklist.mdreferences/subject-tools.mdsituational-domains.mdsituational-tools.mdsubject-examples.mdsituational-examples.md详细介绍
解释技能
版本: 1.0 来源: Explaining Things Playbook
结构先于技巧。深度先于细节。背景先于内容。
范围与边界
本技能涵盖: 生成清晰的解释——对请求进行分类、选择结构、调整深度,以及运用增强亲和力的工具。
本技能不涵盖: 营销文案的写作风格或语气、正式学术写作,或说服式销售。本技能涵盖说服的结构(情境框架),但不涉及文案写作技巧。
与其他技能的关系:
- 与
documentation配合使用(该技能涵盖要记录什么;本技能涵盖如何解释) - 在教学、引导新人或传达概念时,可应用于任何领域技能中
北极星
目标: 听众第一次听就能建立正确的心智模型。
定义: 好的解释不只是传递信息——它还能引导听众,循序渐进地建立理解,并将意义与他们已经在意的事物联系起来。
警示信号: 如果听众听完解释后问“等等,它到底是什么?”,说明你跳过了背景。如果他们问“好吧,但这跟我有什么关系?”,说明你跳过了关联。如果他们问“它实际是怎么运作的?”,说明你讲内容讲得太快了。
快速开始
已经了解框架?从这里开始:
| 我想要…… | 前往 |
|---|---|
| 解释某事是什么或如何运作 | 使用主题框架(默认) |
| 解释某事为何重要、进行说服,或帮助他人做决定 | 使用情境框架 |
| 查看不同深度下的主题示例 | references/subject-examples.md |
| 查看不同深度下的情境示例 | references/situational-examples.md |
| 查看特定领域的映射(讲故事、数据、咨询等) | references/situational-domains.md |
| 按阶段浏览主题技巧 | references/subject-tools.md |
| 按阶段浏览情境技巧 | references/situational-tools.md |
| 并排比较短/中/长三种深度 | assets/depth-comparison.md |
| 按步骤查看检查清单 | assets/explanation-checklist.md |
如需完整框架,请继续阅读。
执行顺序
对于每个解释请求,都应按以下顺序执行,不要跳过任何步骤:
- 分类请求(主题还是情境)
- 应用对应的三阶段结构
- 选择深度(短/中/长)
- 添加辅助工具(示例、类比、重新构建认知),仅在有助于清晰表达时使用
分类
主题(默认)
在解释某事是什么、如何运作、如何做某事,或为何存在时使用。
听众需要理解一件事物。
情境
在解释某事为何重要、为何某种方法更好、如何做决定,或如何说服他人/重新构建行为认知时使用。
听众需要做决定或改变看法。
默认行为
- 默认模式: 主题——除非听众明显正在做决定、进行论证、说服他人或重新构建认知。
- 默认结构: 使用完整的三阶段框架。不要跳过背景。
- 默认清晰化方法: 如果出现困惑,就退回一个阶段,重建心智模型后再继续。不要继续补充更多细节——回到缺失的阶段(通常是背景),重新建立模型,然后继续。
主题框架
使用三阶段结构。在有帮助时,运用增强亲和力的工具辅助解释。
阶段 1:背景——建立理解锚点
引导听众。说明事物是什么、属于什么范畴,以及为何存在。假设听众没有任何先验知识。
从“是什么”和“为何重要”开始。你的目的是引导,而不是说服。给出尽可能简单的定义或概述,并让内容贴近听众。
阶段 2:内容 — 展示它如何运作
解释它如何运作或如何操作。内容要具体、语义清晰,并通过示例展开。除非必要,否则避免抽象表述。
从视觉或逻辑上拆解主题。通过类比、步骤或演示让内容变得具体可感。
阶段 3:连接 — 转化意义
阐释意义。解释它为何重要、何时有用,或它如何改变结果。
以相关性或影响收尾:说明它如何融入生活、为何有用,或它揭示了怎样的世界。
各个深度的完整示例:
references/subject-examples.md按阶段划分的技巧目录:references/subject-tools.md
情境框架
采用 3 阶段结构。解释要有条理、实用并扎根于现实。优先使用具体的思维模型,而非正式定义。
阶段 1:建立背景
先帮助人们了解方向、目的和相关性,再展开后续内容。解释正在发生什么、为何重要,并联系听众看重的事物,让大家目标一致、方向明确。
阶段 2:揭示问题或机遇
通过呈现当前状态与更好状态之间的差距,聚焦注意力并增强情感冲击。揭示其中的矛盾或未实现的潜力,激发好奇或关切,并明确如果一切维持现状,利害何在。
阶段 3:解决问题
清晰地给出答案、想法或前进路径,并提供依据和行动方案。呈现关键洞见,用推理或证据加以支持,并将其转化为具体的后续步骤,让人们明白该做什么以及为何可行。
各个深度的完整示例:
references/situational-examples.md特定领域的映射:references/situational-domains.md按阶段划分的技巧目录:references/situational-tools.md
深度调整
深度决定了要呈现多少思维模型,而非采用哪种结构。三个深度都使用相同的 3 阶段框架。
短
优先保证清晰并给出定义。每个阶段用一两句话。示例尽量精简。
- 语气: 简洁直接——像精炼的教学笔记。
- 工具: 少用——仅作简短、实用的比较(“可以把它想成……”)。
- 适用场景: 电梯演讲、摘要、快速回答、记忆提示。
中
解释机制和直觉。展开因果关系。使用一个说明性示例。
- 语气: 自然、口语化——读起来像一位优秀教师的讲解。
- 工具: 偶尔使用——通过明喻和简短类比降低理解门槛。
- 适用场景: 博客章节、教育视频、演示旁白、内部简报。
长
深入探讨细微差别、权衡和深层见解。使用多个示例、类比或边界案例。
- 语气: 富有反思性和叙事感——读起来像讲述者通过洞见传授知识。
- 工具: 经常使用——丰富的隐喻、类比和轶事,让行文流畅、令人印象深刻。
- 适用场景: 长篇文章、主题演讲、随笔、纪录片旁白、深度研讨会。
完整对比表:
assets/depth-comparison.md
拉近距离与强调工具
仅在有助于清晰表达时使用。结构负责承载解释;工具则为其增色。
| 工具 | 作用 | 使用场景 | 示例 |
|---|---|---|---|
| 明喻 | 使用“像”或“如同”进行直接比较 | 让观点生动易于想象 | “不提供上下文就开始解释,就像盖房子没有地基。” |
| 隐喻 | 暗示一件事就是另一件事 | 引发情感共鸣,拉近不同观点之间的距离 | “上下文是理解的基石。” |
| 类比 | 将一种关系映射到另一种关系上的结构化比较 | 通过平行结构建立逻辑理解 | “正如园丁修剪植物以帮助它们长得更茁壮,领导者也会排除障碍,让团队蓬勃发展。” |
| 拟人 | 赋予非人事物人的特质 | 让抽象系统显得鲜活且富有共情 | “数据不会说谎,但它会低声耳语——你得仔细聆听。” |
| 示例/轶事 | 简短的真实故事或实例 | 以经验为抽象内容提供依据,建立信任 | “开始堆肥时,我意识到废弃物不是问题,而是潜力。” |
| 排比 | 使用相似的句式来营造节奏 | 增添流畅感和强调效果,非常适合总结 | “明确衡量,迅速行动,持续改进。” |
按深度使用
| 深度 | 工具用法 |
|---|---|
| 简短 | 少用——仅作简短的功能性比较 |
| 中等 | 偶尔使用——明喻和简短类比 |
| 较长 | 经常使用——丰富的隐喻、类比和轶事 |
快速参考
每次解释前
- 已归类为主题型或情境型
- 使用了正确的三阶段结构
- 已选择深度(简短/中等/较长)
- 上下文阶段已包含且内容充分
解释过程中
- 阶段 1 先引导听众,再引入复杂内容
- 阶段 2 具体、语义清晰,并以示例为主(而非抽象)
- 阶段 3 将含义转化为与听众自身世界相关的内容
- 拉近距离的工具有助于清晰表达,而不是取代结构
- 没有跳过任何阶段
如果出现困惑
- 回到缺失的阶段(通常是上下文)
- 继续之前,先重新构建心智模型
- 不要在当前阶段添加更多细节
反模式
| 反模式 | 表现 | 失败原因 |
|---|---|---|
| 细节雪崩 | 听众困惑时,你反而添加更多信息 | 困惑意味着缺少某个阶段——更多细节只会让缺口更难弥补 |
| 无头解释 | 不交代上下文,直接进入内容 | 听众没有心智模型来承载信息 |
| 悬空解释 | 有上下文和内容,却没有关联 | 信息虽然传达了,却没有转化为意义或相关性 |
| 错误视角 | 听众需要做决定时,却使用主题型框架 | 主题型讲解是什么;情境型则说明为什么现在很重要 |
| 技巧大杂烩 | 每句话都包含类比、隐喻和示例 | 工具只是调味料,不是主菜。结构才是解释的承载骨架 |
| 专家诅咒 | 按照你自己的理解深度来解释,而非听众的 | 应根据听众的起点匹配深度,而不是按照自己的知识水平 |
| 平铺直叙 | 三个阶段的深度都相同 | 即使内容很长,上下文也可以很简短。每个阶段的长度都应符合其目的 |
参考资料
references/subject-examples.md— 三种深度下的主题示例(精益六西格玛、园艺)references/subject-tools.md— 按阶段(背景、内容、关联)整理的主题技巧目录references/situational-examples.md— 三种深度下的情境示例(学做菜、小型团队)references/situational-domains.md— 特定领域的映射(讲故事、数据、咨询、教学、营销、领导力)references/situational-tools.md— 按阶段(设定背景、揭示问题、解决方案)整理的情境技巧目录
资源
assets/depth-comparison.md— 所有维度的简短 / 中等 / 详细对比assets/explanation-checklist.md— 编写解释的分步执行清单