进阶 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。