do-not-ship-an-empty-surface
空的界面、标签页或分类,是产品没有兑现的承诺。有内容之前先藏起来,或者干脆先别做。
由读过该卡片的评审者赋予,而不是文件自我声明的。智能体在处理不可信内容的运行中提炼出的卡片,生来即被标记为受污染,在被检索之前会一直等待评审。
何时会想到它
- 加一个没有数据的标签页
- 这个分类下一篇都没有
- 占位页面
- 敬请期待
价值通常在「避免」和「检查」里。「该做」是人人都会写的那一节。
上面的卡片正文是译文。英文原文才是 CLI 导入的内容、智能体运行时读取的内容,也是下方哈希所证明的内容。
触发
你即将上线一个对大多数用户来说都是空的、可导航的目的地:一个没有行的标签页、一个没有条目的分类、一个数据源还没接通的仪表盘、一个写着"敬请期待"的页面。
这条不适用于因为用户还没做任何事而为空的界面。一个没有任务的任务列表是正确的,只是应该说明如何添加一个任务。
该做
- 判断这是哪一种空。因为用户是新来的而空,需要一个好的空状态,里面带着下一步该做什么。因为我们还没做出来而空,则不应该存在。
- 对第二种情况:干脆不要渲染这个目的地。只有当背后确实有内容时,才生成这个路由。
- 如果出于开发需要它必须存在,就用一个开发标志把它拦住,让正式安装的构建版本到达不了它。
- 如果这种"空"本身就是值得说的消息——比如一个只有一条内容的中心页、一个刚刚起步的动态流——就用文字把它说出来,把邀请用户贡献内容变成这个页面的主要内容。
避免
"敬请期待"、没有任何解释的"暂无数据",以及一个通向空白栏目的导航项。每一个都让读者点了一次却什么都没得到,两次之后他们就不再信任这套导航——这个代价会由产品里的每一个其他页面来承担。
也要避免那种看起来没问题的版本:一个零条目也能正常渲染的分类页面。它看起来没坏,所以没人会去报告,它却在悄悄地宣告这个项目已经放弃了那个主题。
检查
用一个空的数据源加载这个界面,看看首次访问的用户会看到什么。如果答案只是一个标题加一片空白,它就不该上线。
对于生成出来的路由,检查方式是机械化的:断言路由列表是从内容派生出来的,这样一个没有条目的分类根本不会产生任何页面。
风险
在有内容之前隐藏一个目的地,会导致导航随着数据到来而变化,这可能让人迷失方向——一个在两次访问之间悄悄变多的菜单,需要用户能推断出一个理由。
这条也可能被过度使用,用来隐藏那些只是不受欢迎的功能。分界线在于这个界面是否终将能展示出些什么:未建成的应该隐藏,未使用的应该配上一个好的空状态展示出来。
如何使用
卡片就是数据。克隆仓库并按路径导入——任何经由网络到达的内容都会被视为受污染并等待批准,这正是你想要的行为,也是这里没有一行命令安装器的原因。
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/do-not-ship-an-empty-surface/SKILL.md完整性
文件发布版本的 SHA-256。导入方可以据此核对收到的内容与本页展示的一致。
c4dbc6291edf3d41c3820bea6ed19cd283dd90e75d41d61dad97bdab972b7965