示例是最有效的能力展示
别名: 示例展示能力 · 样例即说明书 · worked examples as affordance
概念解释
「能写周报、能改合同、能解释代码」是断言。一条带着输入和输出的短例是证据。用示例展示能力（example-based capability display）说的是：在开放语言入口上，人用来建立「我能说什么」的最快材料，是看过一次完整的说—得循环，而不是读功能名或能力形容词。示例在这里的职务是展示，不是降低起步成本的填空架子——那是模板的事。
人不是先形成能力清单再找例子，而是从例子反推清单。没有例子，开放输入只剩下「可以打字」这一条可供性。
机制
工作样例效应在教学里成立，是因为样例把目标状态和到达路径同时外化。生成入口缺的正是路径：菜单没有，命令没有，只有语言。一条示例同时给出合法输入的形态、输出的粒度、以及二者的对应。信息气味来自具体物：看到「把这张表转成三张图」，比看到「数据分析」更能判断自己那份季度表能不能扔进来。
抽象标签还容易被乐观解读。「写作助手」可以被听成小说、公文、情书、论文。示例把解读钉死在它所演示的那一类上。钉得太死会收缩使用范围——那是后话；没有钉，发现性根本起不来。
怎么研究
第一使用，任务自选或从一份隐藏的任务菜单里挑。比较三种能力展示：形容词标签、功能名列表、带输入输出的短例。因变量：用户尝试的任务是否落在真实能力内、尝试前的口头能力清单与真实清单的重叠、从看到入口到第一次合法请求的时间。自变量再加示例是否含输出预览、示例是否可一键代入。
不要把「点了示例之后任务完成得更好」算进这条——那混进了模板脚手架。这条只计发现：人有没有说出或点出一种系统确实能做的事。
边界
用户已经从别处知道自己要哪一个功能（邮件里的深链、同事口头教的那一句），示例的发现价值下降，只剩确认。专家面对自己每天的工具，会跳过示例直接打行话。示例若与当前文档上下文无关，会被当成装饰而不是能力证据。这条不讨论示例该放在空状态还是别的位置，也不讨论帮助中心文章能不能替代现场展示。
怎么落地
- 在生成入口的可见范围内放少量完整短例：用户会说的那句话 + 结果长什么样。不要只放能力形容词。
- 示例必须来自真实能力，并且失败类不要混进成功墙。展示的是「能做成这样」，不是「有一次碰巧像样」。
- 示例可点进输入框，但点进之后仍应看得出这是一条示范，而不是已经替用户做完了决定。
- 验证：新用户只看入口三十秒，合上屏幕，写出「它能帮我做什么」。对照你们的真实工具列表。若写出的条目对不上任何一条示例所演示的任务族，示例没有完成展示；若完全写不出，现场没有有效示例。