mcpField
M
melech-make-it-click

melech-make-it-click

github.com/adirdAgent 工作流4541 次安装3 周前更新
代码仓库

关于 melech-make-it-click

用于处理先前解释虽正确却未能让人理解的情况。它找出可能的困惑点,再用具体例子或不同的思维模型重新说明。

主要功能

  1. 01定位具体困惑点
  2. 02使用具体例子或数值
  3. 03说明变化前后
  4. 04替换失效的思维模型
  5. 05保持回答聚焦

适用场景

  1. 01澄清难懂的技术解释
  2. 02追踪运行时数值的所在位置
  3. 03解释标识符存在的原因

安装

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

$npx skills add https://github.com/adird/agent-shell-hamelech --skill melech-make-it-click

安装后在 Claude Code 中输入/melech-make-it-click确认已加载。

附带文件references/examples.md

详细介绍

让它变得一目了然

用户发出这个请求,是因为你之前的解释虽然聪明、内容密集或技术上正确,但他们还是没听懂。

不要为之前的解释辩护、做总结或只把它缩短。找出阻碍用户理解的最小问题。先用最具体的方式解释这一点。不要试图简化之前的整段回答;要换掉那个行不通的思维模型。

找出问题所在

结合对话,尤其是用户最新的措辞,判断他们究竟卡在哪里。问题通常比整个主题小得多:

  • “剩下的数据会被丢弃吗?”
  • “程序运行时,这个值存在哪里?”
  • “为什么还需要这个额外的标识符?”

先回答这个问题,即使之前的回答还讲了十件别的事。如果根据上下文能看出用户哪里没弄懂,就不要再让他们重复说明。如果有两个或更多同样可能的卡点,就问一个范围明确的问题来区分,而不是猜测。

换一种讲法

之前的讲法已经不起作用了。换一种方式:

  • 用一个具体输入,演示它在系统中的处理过程;
  • 举一个简短的值或代码示例;
  • 用直白的话说明前后有什么变化;
  • 只有在对应关系清晰时才用类比;
  • 如果问题在于概念太复杂,而非措辞难懂,就删去不必要的概念。

多用具体的事物和动作,少用抽象类别。一次只引入一个概念。在必须使用术语时,立即解释它的含义。

回答结构

  1. 开头直接回答用户可能卡住的问题。
  2. 用最精简的具体模型说明为什么答案成立。
  3. 用一句话把它与原主题联系起来。
  4. 到此为止。只有在核心意思讲清楚后,才补充更深入的细节。

不必强行使用类比、编号步骤或“用最简单的话解释”的语气。根据用户的困惑选择合适的讲法。目标是让用户理解,而不是遵循某种固定格式。

严格要求

  • 不要换成更简单的词,重复同一套解释。
  • 如果问题不在于基础概念,就不要从头讲起。
  • 不要只因术语精确就保留晦涩说法。
  • 不要罗列所有注意事项、分支情况、实现细节或相关概念。
  • 不要像对孩子说话,也不要宣称自己在“把内容讲简单”。
  • 不要把补充解释变成另一篇长文。
  • 先给出新的解释,不要问“这样说清楚了吗?”

如需查看三种不同讲解方式的实例,请参阅 references/examples.md。

评论

支持 Markdown