Impeccable clarify面向 AI 助手的界面文案澄清与 UX Copy 重写指南【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable导读本篇文章解析 Impeccable 设计语言中的clarify命令/impeccable clarify [target]它专门用于重写用户读不懂的界面文案UX Copy当界面中的标签、错误提示、空状态、加载文案含糊不清时clarify会把它们改写成用户能立即理解发生了什么、什么重要、下一步做什么的表达同时保留事实含义、产品术语与品牌语气。读者将掌握一套完整的方法论——从语言审计、信息层级设定到按功能分类重写操作与导航、表单、错误与权限、加载/空/成功状态、帮助文本再到语音、无障碍、本地化与最终验证清单并了解它在 Impeccable 命令体系中的定位与交接流程。一、clarify 在 Impeccable 中的定位Impeccable 是一套让 AI 编码助手在界面设计上表现得更好的设计语言项目描述The design language that makes your AI harness better at design.。在技能体系plugin/skills/impeccable/SKILL.md中clarify属于Fix修复类别的命令位于 Commands 表格的第四行分类命令类别描述clarify [target]Fix改进 UX 文案、标签与错误消息Improve UX copy, labels, and error messages它与其兄弟命令的分工清晰audit检查技术质量可访问性、性能、响应式critique做启发式 UX 评审polish做上线前的最终质量收尾而clarify专门处理语言层面的问题——用户看不懂、误读、或感到困惑的文案。argument-hint也给出了一句话定位clarify 是独立可调用动词可配合目标路径使用如/impeccable clarify src/components/BillingForm.tsx。调用clarify时遵循技能的标准工作流先运行impeccable context加载项目上下文PRODUCT.md、DESIGN.md、surface brief再按 Commands 表读取本参考文件随后才开始编辑。本文接下来展开的正是该参考文件plugin/skills/impeccable/reference/clarify.md的完整方法论。二、核心原则让用户明白发生了什么、什么重要、下一步做什么clarify的使命可以用一句话概括重写不清楚的界面文本让用户理解发生了什么what happened、什么重要what matters、下一步做什么what to do next。保留事实含义factual meaning、产品术语product terminology与品牌语气brand voice。三个关键词限定了改写边界事实含义不可变不能为了通顺而改变事实陈述涉及事实声明、法律含义或领域特定术语的改动必须先询问用户Ask before changing factual claims, legal meaning, or a term that may be domain-specific。产品术语不可丢术语是产品知识的一部分不能用大白话抹平用户真正认识的行业词汇。品牌语气要延续Voice 保持一致Tone 随情境压力、风险、成功、紧迫感灵活调整。三、第一步审计语言Audit the language改写的起点不是盯住单个字符串而是阅读整条交互路径Read the entire interaction path, not isolated strings。因为一条文案孤立的看可能没问题放在用户从入口到完成的整条链路里才会暴露认知断层。审计时逐个检查以下问题清单含糊的名词、动词与动作用户能否确定这个按钮点击后会发生什么内部行话与隐含知识是否默认用户知道团队内部才懂的缩写或概念含糊的标签、结果与系统状态已更新处理中到底指什么缺失的后果、恢复方式或时机失败之后用户能否知道如何恢复、要等多久术语与大小写不一致同一概念在界面上是否始终使用同一个词、同一种写法冗余的标题、引言、辅助文本与确认标题已经说明状态时正文是否还在重复在真实宽度或翻译中会断行的文本长文案在窄容器、200% 缩放或本地化扩容后是否破碎忽略压力、风险、成功或紧迫感的语气删除操作却用轻松随意的语气是否合适同时要求从产品上下文与周边 UI 推断受众与任务——同一句文案面向首次使用的新手与面向高频操作的管理员写法完全不同。无法从上下文确定受众时优先向用户求证而不是猜测。四、第二步设定消息层级Set the message hierarchy对于每一个状态state在动笔前先决定四层信息此刻用户唯一需要的事实the one fact the user needs now下一步可执行的动作the action available next会改变决策的支撑上下文supporting context that changes the decision适合这一时刻的语气the appropriate tone for this moment。关键纪律是一个想法只说一次Say each idea once如果标题已经解释了当前状态正文就应该补充新信息或者干脆删掉。界面上的每一段文字都要有存在的理由而不是装饰。这条原则在 Impeccable 的运行时实现中也能看到呼应实时协作 chrome 的消息面toasts 与错误被定义为独立 UI surface见 crates/live/src/vocabulary.rs 中的toasts-and-errorssurface意味着当前状态下一动作的传达是系统级能力而不是每个组件各自为政的随机文案。五、按功能分类重写Rewrite by function5.1 操作与导航Actions and navigation当结果不明显时使用具体的动词宾语。标签描述的是将要发生什么而不是触发它的手势拖拽点击右上角这类手势描述不进入标签。同一概念在整个产品中保持同一个名词和动词Keep the same noun and verb for the same concept throughout the product。对破坏性操作明确命名对象与后果例如删除项目后将无法恢复而非确认删除。能安全恢复时优先提供撤销undo而不是确认框。当确认框不可避免时消息和按钮上都要写动作名而不是只写Yes/No/OK/Submit——按钮上写删除项目永远比写确定更能防止误操作。5.2 表单Forms使用持久化标签persistent labelsplaceholder 只是示例不能当标签用。格式与资格要求放在提交之前说明而不是等用户提交后报错。只有当为什么需要这些信息不明显时才解释收集原因。必填与选填的处理要一致Required and optional treatment should be consistent。校验消息要说清哪里需要关注、如何修正且不指责用户请输入 8 位以上密码优于密码错误。相关说明放在字段附近错误要通过可访问的方式宣告如aria-live区域的 rolealert 播报。5.3 错误与权限Errors and permissions一条可行动的错误消息必须回答三个问题什么失败了what failed为什么——当已知且有用时why, when known and useful如何恢复或还有什么替代路径how to recover or what alternative remains。硬性禁令不要把内部错误码作为主消息Error 0x80070005对用户毫无意义内部码可以放在次要位置供支持团队使用。不要承诺系统无法得知的原因或解决方案不要编造权限不足如果你并不确定。对待隐私、支付、删除、访问丢失、任务被阻塞必须严肃温暖欢迎warmth is welcome但玩笑绝对不行jokes are not。5.4 加载、空与成功状态Loading, empty, and success states加载文本要命名真实操作并在等待有意义时给出诚实的预期正在同步 12 个文件优于加载中…。有确定进度时展示确定进度条永远不要编造进度never invent progress。空状态要区分五种情况首次使用、无结果、过滤器过滤、权限不足、失败。每种情况分别说明状态并提供下一个有用的动作没有匹配的项目试试调整筛选条件。成功状态确认已完成的结果只有当后续结果会改变用户接下来该做什么时才提及下一步后果。例行成功应尽量简短。5.5 帮助与说明文本Help and instructional text辅助文本回答一个隐含的问题而不是复述控件。按钮叫导出旁边就别再写点击此按钮导出。不常见的细节用渐进式披露progressive disclosure默认收起需要时展开而不是把所有细节平铺。链接文本脱离上下文也要成立了解更多关于导出格式优于了解更多。仅图标的控件必须有可访问名称accessible name。六、语音、无障碍与本地化Voice, accessibility, and localization语音voice保持一致语气tone随情境调整。使用平实语言但不要抹平受众真正熟悉的术语。写完整可翻译的句子而不是拼接的碎片You have 3 items 而不是把 You have count items 拆开。变量与数字保持结构化让翻译者可以自由调整语序ICU MessageFormat 风格的占位符正是为此。允许扩展不要过早缩写德语、芬兰语等语言的文案会比英语长 30% 以上UI 要预留空间。alt 文本传达图片的信息纯装饰图使用空 altalt避免屏幕阅读器朗读无意义内容。屏幕阅读器名称与可见标签、结果保持一致。不要单独依赖标点、颜色或图标传达信息——文案本身必须自足例如错误不只靠红色图标表达。当不一致横跨整个产品时维护一份简短术语表terminology glossary不要为了文采在界面中换词Do not vary words for literary effect in an interface。七、验证Verify改写完成后回到上下文中通读整个流程并逐项测试无需隐藏的产品知识即可理解comprehension without hidden product knowledge脱离团队背景的用户能否读懂错误、空状态与决策点的可行动性每个需要用户行动的地方是否都给出了下一步事实准确性与术语一致性。在目标宽度与 200% 缩放下可扫读scanability。长名称、本地化扩展、复数形式与动态值1 item/2 items、1 天/2 天这类形态是否正确处理可访问名称与状态变更播报accessible names and announced state changes。语气与后果、情绪情境相称。最终验收标准是一句话The final copy is as short as it can be without removing meaning or recovery.最终文案应短到不能再短但不能以牺牲含义或恢复指引为代价。八、交接与命令工作流clarify不是终点。文档明确要求当语言读起来干净了交接给/impeccable polish做最终收尾When the language reads cleanly, hand off to/impeccable polishfor the final pass。polish是精修而非隐藏式重设计见 plugin/skills/impeccable/reference/polish.md它的三梯队优先级恰好接住了clarify之后的剩余工作先修功能性缺陷与误导性状态再补缺失的状态loading/empty/error/success/disabled/permission最后处理层级、响应式与设计系统漂移。也就是说clarify解决用户读不读得懂polish解决整条路径是否完整一致。从源码层面看Impeccable 甚至为文案编辑提供了自动化管线clarify这类语言改写在 Live 模式下通过 copy-edit 批量机制落地crates/live/src/copy_edit_agent.rs 中定义了完整的批量应用提示词要求 AI 代理把 staged 的浏览器文案编辑应用到真实源文件并把originalText/newText视为字面数据而非指令——这与clarify文档保留事实含义的原则一脉相承。它还强制校验不得残留编辑模式脚手架data-impeccable-*标记、contenteditable 等、文本必须作为合法源码语法写入JSX/TSX 中等字符要用引号表达式包裹、JSON/JS 文件要通过语法检查见 crates/live/src/copy_edit_agent.rs 的run_copy_edit_post_apply_checks。九、应用建议一次完整的 clarify 实战路径把整套方法论落成可执行步骤定位/impeccable clarify targettarget 可以是文件路径或路由对全新会话先运行impeccable context确保产品上下文就位。读整条路径从入口到完成把所有状态含错误、空、加载、权限的文案全部收集而不是只盯报错弹窗。逐条按四层消息层级排序每一条文案问用户此刻需要知道的事实是什么下一步动作是什么有没有多余的第三层语气对吗按功能类目套用规则按钮/导航看动词一致性表单看标签持久化与前置说明错误看三要素什么失败/为什么/如何恢复空状态先区分五类成因。做本地化与无障碍体检检查拼接碎片、占位符顺序、200% 缩放断行、屏幕阅读器名称与可见标签一致性。验证并交接跑完验证清单后交给/impeccable polish做整条路径的最终收尾。按此路径clarify能把最容易伤害产品信任的界面角落——含糊的错误、吓人的确认框、空无一物的空状态——改写成用户真正看得懂、能行动的文案同时保证事实、术语与品牌语气毫发无损。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
