67 次新增安装后，这个 Skill 想把 Agent 的解释变成一张图

8 月 12 日晚间，我在 skills.sh 的热门榜看到一个很小、但方向很准确的信号：HumanLayer 新加的 show-me 在当时显示 67 次新增安装，累计安装 229 次；它在平台上第一次出现还是两天前。这个数字不是 GitHub stars，而是 skills.sh 的安装信号。它之所以值得看，不在于 67 有多大，而在于它把 Agent 回答里常被忽略的一件事单独做成了能力：别只解释，必要时把关系画出来。

这篇会把 show-me 的工作方式拆开，也看看它为什么会在刚发布几天后进入热门榜。期望对大家有所帮助。

从一段话换成一个最小视图

show-me 的指令并不复杂。它让 Agent 跳过铺垫、压缩文字，并为当前问题挑选“最小、最能说明问题的视图”。逻辑适合伪代码，运行路径适合调用树，组件边界适合组件树，重构的责任划分适合浅层文件树；涉及交互或数据流时可以用 Mermaid；只有 Mermaid 仍然装不下时，才写一张聚焦的 HTML 图或短幻灯片。

这其实是在约束一种常见的 Agent 失败方式。面对“缓存为什么没有刷新”“这个表单提交经过哪些层”“这次重构谁负责什么”这类问题，模型很容易输出一段正确却难扫读的文字。show-me 不把“可视化”理解成再堆一张功能海报，而是把它当成回答格式的选择：只保留当前判断所需的调用、文件、状态和边界。

例如，一个缓存问题不必画完整架构图。Skill 的示例只需要给出下面这条分支：

on(save)
  if content is unchanged
    return cached result
  write new content
  return fresh result

这里真正重要的是“相同内容直接返回”和“写入后返回新结果”的先后次序。文字当然能讲清楚，但这六行更快让人看到判断条件在哪里。

它不是一个画图工具

把 show-me 当成 Mermaid 模板包会低估它。它包含的不是某一种图的语法，而是一条决策规则：先看问题的形状，再选显示方式。

问题形状	优先输出	读者要确认的事
条件与步骤	伪代码	顺序和分支
一次运行的路径	调用树	谁调用谁
目录或模块职责	文件树	所有权边界
变更前后	diff	多了或少了什么
多方交互	Mermaid	消息、数据或状态如何流动

Skill 甚至对 diff 给了不同形状：组件改动就展示组件树的增减，文件布局改动就展示目录变化，调用链变化就把新增节点塞回调用树。这个细节很实用。读者通常不需要从零认识整个系统，只需要看清这次改动改变了哪一段关系。

等信息密度高到这些文本图都不够时，它才建议写 HTML，并要求使用真实标签和数据、兼顾桌面与手机。这个顺序避免了另一个常见问题：为了“看起来可视化”，把一个本可用 10 行文本讲清的关系做成笨重图片。

为什么是现在

这波关注有两个可核实的时间信号。

第一，show-me 的源文件在 8 月 9 日首次提交。随后在 8 月 9 日和 8 月 11 日连续修改，分别调整了 HTML 的打开方式，以及文件树示例使用真正的 box-drawing 字符。也就是说，进入榜单时它并不是一个放上去就不再维护的提示词片段，而是在根据实际输出继续收紧格式。

第二，skills.sh 的热门榜在本次观察时把它列为第 1 位，标记为 67+67；详情页给出的累计安装是 229，仓库页面当时是 144 GitHub stars。三个数字指向不同含义：榜单上的 67 是短期新增安装信号，229 是平台累计安装，144 才是 GitHub stars。把它们混成“67 stars”或“单日涨 67 stars”都会失真。

HumanLayer 不是匿名拼装仓库。GitHub 资料显示它是 2024 年创建的组织，有 20 个公开仓库和约 1,422 位关注者；其官网把产品定位为 AI IDE、协作平台和软件开发工作流的构件。show-me 的提交者 Dex 在 GitHub 资料中也明确关联 HumanLayer。这里能确认的是发布方和维护活动，并不能由此推出这个 Skill 的质量已经被大规模验证。

对使用 Agent 的人，它解决的是交接成本

Agent 的长任务通常有两个读者：发出指令的人，以及稍后接手的人。前者要快速判断“它理解对了吗”；后者要知道“代码已经走到哪里”。纯文字在这两个时刻都不够友好。

show-me 的价值更像一层交接协议。让 Agent 在解释复杂对象时贴近问题输出一张小图，就能把 review 的入口从一大段自然语言，缩小成一个可核对的结构。

flowchart LR
    A[用户提出问题] --> B[Agent 判断问题形状]
    B --> C{最小视图}
    C -->|控制流| D[伪代码或调用树]
    C -->|边界| E[组件树或文件树]
    C -->|交互| F[Mermaid]
    C -->|信息过密| G[聚焦 HTML]
    D --> H[人快速核对]
    E --> H
    F --> H
    G --> H

这里的关键词是“贴近问题”。如果你让 Agent 每一次回答都强制附图，图很快也会变成噪声。更适合的触发条件是：存在分支、调用链、模块所有权、状态转移，或者变更前后难以靠一句话比较时。对于一个 API 参数、一个报错原因或一段可直接复制的命令，正常文字反而更好。

尝试之前，先做两件事

安装命令是 npx skills add humanlayer/skills --skill show-me。在把它放进团队仓库前，我会先把它当作输出约束而不是事实来源，并确认两件事。

• 让它只为需要结构判断的回复生成图，避免每次回答都制造额外产物
• 检查 Mermaid 与 HTML 是否使用真实的文件名、函数名和数据，不能让一张漂亮的示意图掩盖错误边界

show-me 的新鲜感和安装信号，说明不少人正在尝试把 Agent 从“会说”推进到“能让人快速检查”。它还很年轻，当前 GitHub stars 和安装量都不构成成熟度证明；但它选中的问题很具体：当解释本身是一段需要 review 的交付物时，最短的文字未必是最清楚的答案。

---

• Skill 源码：humanlayer/skills
• skills.sh 详情页：show-me