刊 DailyNews 科技 / AI 每日文摘2026 年 10 月 30 日

每日文摘

深挖 · show-me：被 Matt Pocock 带火的 3.3KB skill，治好 coding agent 的「文字墙」

题图

这两天你的时间线大概刷到过「Matt Pocock 出了个新 skill 叫 show-me」。先把误传纠正掉：show-me 不是 Matt Pocock 做的——它是 HumanLayer 创始人 Dex Horthy 的作品，Matt 只是在 9 月 3 日发了一条盛赞它的推文（81.4 万阅读、7.4k 赞），把一个上线三周的 skill 直接带出了圈。这个东西有多小？一个 3,297 字节的 SKILL.md，零脚本零依赖。它治的病所有 coding agent 用户都熟：agent 输出的文字墙（walls of prose）——你问一个调用链，它还你五段散文。上线约 4 周，skills.sh 显示 10,781 次安装，同名 skill 里排名第一。这篇照旧拆技术、环境、评测，最后说说它和今天早些时候深挖的 diagram-design 是什么关系。

是什么：先把误传纠正掉

show-me 的源码在 humanlayer/skills 仓库的 plugins/show-me/ 下，全部 4 个 commit 都由 dexhorthy 本人提交，首个 commit 是 2026-08-09，三天后（08-12）Dex 发了发布博客。我做了排除性核查：mattpocock/skills 主分支 37 个 SKILL.md、官方 plugin.json 的 27 个 skill 清单、Matt 名下 223 个仓库，都没有 show-me。

Matt 的角色是背书者。他在那条推文里写："/show-me is a phenomenal skill. Makes PR descriptions extremely easy to read. Basically a toolbox of ’nice ways to look at code’"，链接直指 humanlayer 的 SKILL.md 并公开署名 @dexhorthy。更有意思的是谱系方向恰好相反——Dex 在博客里致敬的是 Matt 的 /teach skill（HTML explainer 形式的灵感来源），外加 Dillon Mulroy 的 /bro。新闻源把「带火」写成「发布」，就这么以讹传讹。

它解决的问题，Dex 博客的标题章节说得很直白：“Coding agents are pretty much unreadable”——模型越来越聪明，输出体验却在倒退。show-me 的官方定义一句话：“Explain the current topic with concise diagrams, code-shape sketches, and focused HTML artifacts”。

核心机制：一个 SKILL.md 装下的「表示工具箱」

建议直接去读 SKILL.md 原文，3.3KB 两分钟读完。内容是 8 种「最小可读表示」的示范，外加一条内嵌原则：

  1. 伪代码——讲算法和逻辑
  2. 调用树 call tree——讲运行时控制流
  3. 组件树——用 JSX 形状写组件边界与 state 归属
  4. 浅层文件树——一行一个职责注释
  5. Mermaid——偏 state / sequence
  6. diff 语法，且按主题分四种形状：组件变更、文件布局变更、调用树变更、状态/控制流变更
  7. 整段代码块——大部分是新代码、或需要可复制的目标形状时
  8. HTML artifact——明确说是 “too dense for Mermaid” 时的兜底，落一个自包含单文件 show-me-{description}.html，要求匹配产品配色与真实数据

内嵌原则：每种视觉产物紧挨它支持的短文本；“You may use one of these, you may use several, it is unlikely you will use all of them”。

关键理解：前 7 种都不产生文件，是对话流里的纯文本；只有第 8 种落盘并用 Bash open 打开（最初用 task-artifact 方式，08-09 的 commit 改成了 Bash open）。这决定了 show-me 的本质不是「画图 skill」，而是输出格式纪律——反复强调 “Pick the smallest view that makes the key point clear”，九条格式 unlikely 全用，挑最小够用的那个。

这个定位有独立证据。日本博主 masa_wunder 在 note.com 横评里的意外发现是：裸 Claude（不带任何 skill）也能画出可用的图，skill 的真实价值是稳定输出格式——没有它时好时坏，有了它每次都是这几招。X 讨论串里还有个说法解释了为什么做成 skill 而不是写进 CLAUDE.md：“when the instruction is soft I drift, when it’s a switch I comply”（软指令会漂移，开关才会遵守）。

顺带看一眼 HumanLayer 自己怎么用它：release notes 显示 v0.154 加入 /rpi:show-me 命令，v0.160 让自家产品的 PR 描述对齐 show-me 格式——skill 免费开放做声量，产品体验承接变现，这个打法值得做工具的人学。

怎么跑起来（环境）

安装三条路任选：

运行期零依赖：无 Node 服务、无端口、无浏览器自动化、无外部 API、无 key，装完离线可用（Node ≥22.20.0 只是安装器自己的 engines 要求）。开销透明：常驻 context 的只有 frontmatter description（123 字符，约 25–31 token），触发时读入全文约 770–825 token，一次性；文本类产物只花输出 token，HTML 产物落文件不进 context。

两个环境注意点：

  1. SKILL.md 字面指令是 macOS 的 open，Linux 上 agent 通常会自适应换 xdg-open，但这是行为推断而非官方适配——自己 vendor 单文件时顺手改掉最稳（explainx 的报道也建议 vendor 而非依赖第三方 CLI 分发，供应链上更干净）。
  2. Mermaid 在纯终端里不渲染，explainx 调侃那种输出是 “just text with arrows in it”。终端重度用户真正吃到红利的是调用树、文件树、diff 形状这些纯文本格式——在哪都能读。

数据说话（评测）

和 diagram-design、archify 是什么关系

同一天深挖了两个「可视化」skill，先回答关系问题：没有关系。diagram-design 的 README 全文（44KB）grep 不到 show-me / humanlayer / pocock，Dex 的博客和 SKILL.md 也完全没提 diagram-design——两边互不知晓。时间上 diagram-design（2026-04）早 4 个月，但没有任何传承证据。

定位是光谱的两端：

show-mediagram-design / archify
产物7/8 是对话内文本成品 HTML+SVG 图文件
哲学最小够用（smallest view）设计质量（密度 4/10、删除优先）
Mermaid主力格式之一“No Mermaid slop”
体感成本触发一次 ~800 token时间与成本「稳定地高」

一句话分工：讨论中途想看懂 → show-me；要产出一幅能进文档、进汇报的成品图 → diagram-design / archify。三者不互斥，可以都在工具箱里。另外 GitHub 上还有两个同名 show-me（angusfretwell 版早两天但只有 23 installs；charlie947 版走「全渲染 + osascript 拉起 Chrome」的激进路线）——认准 humanlayer 版。

顺带一问：skill 到底该怎么装？

这次调研顺带把「skill installer」生态摸了一遍，因为很多人是从 Codex 的 skill-installer 开始有这个概念的：

所以答案是：跨环境的事实标准就是 npx skills——78 个 agent、一次交互装进多个 agent 目录、lock 文件追踪来源。各家官方 installer 都只管自家一亩三分地，而它正好补上这个缺口。至于从 Codex 借鉴自建：值得抄的只有工程细节（curated 列表 + GitHub URL 双来源、direct download 优先 git 兜底、幂等安装），架构上 OpenAI 自己都在往 plugin 体系退，没必要重造轮子。

值不值得跟

回到老规矩，结合「agent 读代码 + 写作输出」的工作流给判断。show-me 的命中点：

  1. 读代码阶段的结构解释——「这个仓库的调用链长什么样」「这次重构动了哪些路径」，调用树/文件树/diff 形状正好是 agent 该回的格式；对用 learn-repo 式方法论啃开源仓库的人是天然互补
  2. 大 diff / PR review——Matt 背书的原始场景，配合 to-issues / triage 这类工作流 skill 食用更佳
  3. 成本几乎为零——3.3KB、常驻约 30 token、单文件可 vendor，是这类 skill 里入库门槛最低的：进中立库、软链到各 agent 目录就完事

什么时候不要用它：要的是能进文档的成品架构图（archify / diagram-design 的领域）、要的是发布用配图（生图链路的领域）。另外记住 note.com 横评那个提醒：裸模型其实也会画图——show-me 买到的不是新能力，是每次都有的纪律。

最后一个彩蛋：想学写 skill 的话，这 3.3KB 的 SKILL.md 可能是全 GitHub 性价比最高的教材——一个文件讲透了「渐进披露 + 具体示范 + 反面约束」三件套。Dex 自述迭代数月的核心动作是 “polishing and mostly removing stuff”。做减法，才是这种 skill 的全部秘密。

参考阅读