mcpField
E
explaining

explaining

github.com/alexanderstephenthompson生产力36 次安装
代码仓库

关于 explaining

用于组织清晰讲解的技能,适合教学、入职引导和概念沟通。它区分介绍事物与辅助决策的讲解,并据此选择结构、深度和辅助技巧。

主要功能

  1. 01区分主题型与情境型请求
  2. 02采用三阶段讲解结构
  3. 03按三种深度调整内容
  4. 04按需使用示例与类比
  5. 05提供清单和完整示例

适用场景

  1. 01讲解概念或流程的运作方式
  2. 02帮助受众在不同方案间决策
  3. 03准备入职引导或教学材料
  4. 04困惑时重新梳理理解框架

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alexanderstephenthompson/claude-hub --skill explaining

安装后在 Claude Code 中输入/explaining确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
depth-comparison.md
explanation-checklist.md
references/
subject-tools.md
situational-domains.md
situational-tools.md
subject-examples.md
situational-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. 选择深度(短/中/长)
  4. 添加辅助工具(示例、类比、重新构建认知),仅在有助于清晰表达时使用

分类

主题(默认)

在解释某事是什么、如何运作、如何做某事,或为何存在时使用。

听众需要理解一件事物。

情境

在解释某事为何重要、为何某种方法更好、如何做决定,或如何说服他人/重新构建行为认知时使用。

听众需要做决定或改变看法。

默认行为
  • 默认模式: 主题——除非听众明显正在做决定、进行论证、说服他人或重新构建认知。
  • 默认结构: 使用完整的三阶段框架。不要跳过背景。
  • 默认清晰化方法: 如果出现困惑,就退回一个阶段,重建心智模型后再继续。不要继续补充更多细节——回到缺失的阶段(通常是背景),重新建立模型,然后继续。

主题框架

使用三阶段结构。在有帮助时,运用增强亲和力的工具辅助解释。

阶段 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 — 编写解释的分步执行清单

评论

支持 Markdown