进阶 impeccable.style 2026-11-22 15:26:08 · 1 阅读

第26章 Agent 缺失的设计词汇

让界面更清楚,帮助用户明白发生了什么、下一步该做什么。本页包含 3 个小节大多数 agent 使用 /impeccable。在 Codex 中使用 $impeccable。

当按钮含义模糊、表单说明让人困惑、报错没有帮助、或空状态让用户卡住时,就用 clarify。Impeccable 会通读整个交互流程,围绕用户在当下需要知道什么来重写文案。

试一试 /impeccable clarify 个人资料表单,包括校验和保存失败的报错。

说明谁在用这个流程、以及他们容易误解什么。提供现有的产品上下文,有助于 Impeccable 选择合适的术语和详略程度。

工作原理 Impeccable 会通读整个交互流程,按文案的职责逐一重写:

操作与导航:写清楚控件的功能,保持术语一致。 表单:让标签更具体,把要求写在用户需要的位置。 报错:解释出了什么问题、如何恢复,但不编造原因。 加载、空状态和成功状态:说明当前状态和下一个有用的步骤。 帮助与确认:补充必要的上下文,删掉重复内容,讲清楚后果。

死胡同 出错了。 确定

清晰的下一步 无法保存你的更改,请重试。 重试

图示为保存失败的报错(假设界面支持重试)。文案说明了什么失败了但不编造原因,按钮则写明自己的功能。

事实性含义和产品术语保持不变。遇到重要事实不清楚时,Impeccable 会向你确认。在不改变含义的前提下,越短的文案越好;但删除操作的警告可能比一个普通的成功提示需要更多解释。

检查结果 把流程的成功、报错、空状态各走一遍:标签和控件的实际功能是否一致?用户遇到问题能否自行恢复?同时检查长名称、动态值、窄屏和可访问名称。

如果措辞清楚了但可读性差,用 typeset;如果首次使用体验需要更大范围的重构,用 onboard。

评论 (0)