Clarify

/impeccable clarify

适用场景

• 用户卡住的主要原因是措辞。
• 界面需要更好的说明、错误文案或 helper text。
• 产品流程没问题，但语言表达拖了后腿。

什么时候用

/impeccable clarify 适合处理那种会让用户停下来想一下的界面文字：标签不清楚，按钮文案含糊，错误提示像在怪用户，tooltip 只是重复标签，空状态什么都没说。问题不在布局，也不在颜色，而在文字时，就该用它。

典型触发语： “用户看不懂这个字段”、 “错误提示没帮助”、 “我不会写按钮文案”、 “这个 tooltip 纯属浪费”。

工作方式

这个技能会在最常出 UX 文案问题的几个表面上重写文字：

1. 标签和字段提示：直接、具体，明确说出系统期望什么。
2. 按钮文案：动词优先，描述结果而不是动作。用“保存更改”，不要只写“确定”。
3. 错误消息：说明哪里错了、责任在哪一侧、下一步该怎么办。不要责怪用户。
4. 空状态：告诉用户自己身处何处、为什么为空、下一步能做什么。
5. Tooltip 和 helper text：补充标签承载不了的信息，而不是复述它。
6. 确认对话框：说清后果，而不是只说动作名称。

它会根据 PRODUCT.md 里的受众和心理状态调整语气。技术用户要精确，消费级用户要口语化，赶时间的人要短句，焦虑场景（支付、删除）要有安抚。

试试看

/impeccable clarify the billing form

前后对比通常会是这样：

• 标签 “Billing address” → “信用卡账单地址”
• 占位符 “Enter your VAT ID” → “VAT ID（可选，企业使用）”
• 错误 “Invalid input” → “这个卡号应为 15 位，你输入了 14 位。”
• 按钮 “Submit” → “支付 29 美元并订阅”
• 空状态 “No transactions yet” → “你的第一笔扣款会在首次下单后显示在这里。”

常见陷阱

• 写得更花，不是更清。 Clarify 不是做 voice upgrade 的。如果文案本来就清楚，不要硬用它。真要加个性，请用 /impeccable delight。
• 跳过“受众是谁”这个问题。 Clarify 必须知道是谁在读。如果 PRODUCT.md 没写受众技术水平，改写结果就会很泛。
• 拿它去写 marketing copy。 Clarify 针对的是功能性 UX 文案：标签、错误、说明、提示。Marketing copy 需要另一套写法，也需要人类作者参与。

相关命令

• Adapt
• Polish
• Onboard