尧图网站建设 
Impeccable 的 clarify 命令详解把含糊的界面文案改写成用户看得懂的 UX 文本【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableimpeccable 是一个面向 AI 编码代理的设计语言技能包其clarify命令专门解决“界面文案让用户看不懂”的问题识别含糊的标签、报错与提示按功能类型导航、表单、错误、状态、帮助文本系统性改写并输出可验证的验收清单。读完本文你将完整掌握clarify的审计方法、消息层级设定、五类界面文本的改写规则、本地化与无障碍约束以及它与audit、polish等命令在 impeccable 工作流中的衔接方式。1. clarify 在 impeccable 命令体系中的定位impeccable 技能通过一张命令表组织全部能力clarify被归类在Fix修复类别中命令类别描述参考文档clarify [target]Fix改进 UX 文案、标签和错误信息clarify.md这是 SKILL.md 中 Commands 表对clarify的完整定义。命令的参数提示为[target]即指定要改写的界面区域功能、页面或组件在 command-metadata.json 中它的触发描述进一步细化为当用户提到“文案令人困惑、标签不清晰、错误信息差、说明难以跟随或想要更好的 UX 写作”时使用。使用方式遵循 impeccable 的标准 Setup 流程每个会话先运行一次.agents/skills/impeccable/scripts/impeccable context该启动器会加载 PRODUCT.md、DESIGN.md、对应的界面简报以及如适用原生平台指引随后再加载clarify的参考文档执行改写。如果想为clarify建立独立快捷方式可以用 SKILL.md 中描述的 Pin 机制.agents/skills/impeccable/scripts/impeccable pin pin clarify生成独立的$clarify命令。若用户不带参数调用$impeccable技能会转入 routing.md 的上下文感知菜单只推荐不自动执行命令。值得注意的是impeccable 各 reference 文档的第一行都会声明该命令所需的“额外上下文”。clarify.md 开头即声明Additional context needed: audience knowledge and emotional state.额外所需上下文受众的知识水平与情绪状态。这意味着执行clarify时代理必须先弄清“读这些文案的人懂多少、处于什么情绪状态”再动手改写——这是整份 playbook 的第一性前提。2. 审计语言读整条交互路径而非孤立的字符串clarify的第一步不是改字而是审计。文档明确要求“读整条交互路径而不是孤立的字符串”Read the entire interaction path, not isolated strings并逐一识别以下八类语言问题含糊的名词、动词与动作ambiguous nouns, verbs, and actions内部黑话或默认用户已知的假设知识internal jargon or assumed knowledge含糊的标签、结果描述与系统状态vague labels, outcomes, and system states缺失的后果说明、恢复途径或时间预期missing consequences, recovery, or timing不一致的术语与大小写inconsistent terminology and capitalization冗余的标题、引言、辅助文本与确认提示redundant headings, intros, helper text, and confirmations在真实宽度下会断裂、或翻译后会出问题的文本text that breaks at realistic widths or in translation无视用户所处压力、风险、成功或紧迫情境的语气tone that ignores stress, risk, success, or urgency。完成审计后代理需要从产品上下文与周边 UI 推断受众与任务。同时有一条明确的边界在改动事实性声明、法律含义或可能是领域专用术语的词之前必须先向用户提问。这条规则防止 UX 改写越权改动产品语义——文案润色不能悄悄改变事实。3. 设定消息层级每个界面状态只回答四个问题审计完成后对每一个界面状态一个弹窗、一个错误页、一个空列表……依次决定四件事用户此刻需要知道的那一个事实the one fact the user needs now接下来可执行的动作the action available next会影响决策的支撑性上下文supporting context that changes the decision此刻恰当的语气the appropriate tone for this moment。配套的写作纪律只有一条但极其严格每个观点只说一次。如果标题已经把状态解释清楚了引言要么补充新信息要么直接删掉。这条规则直接对应审计清单中“冗余的标题、引言、辅助文本”这一项把“删冗余”从感觉变成可执行的判定标准。4. 按功能类型改写五类界面文本各自的规则clarify的核心是把改写规则按 UI 功能切分为五个子域。以下完整继承原文档的每类规则。4.1 动作与导航Actions and navigation当结果不显然时使用具体的动词 宾语标签应描述“会发生什么”而不是描述“触发它的手势”例如描述保存结果而不是写“点击此处”。全产品内同一概念保持同一套名词与动词禁止同义漂移。对破坏性操作文案必须点名操作对象与后果在恢复安全的前提下优先使用undo撤销代替确认对话框。确实需要确认时消息与按钮上都要写明动作本身而不是用Yes、No、OK、Submit这类无信息量的词。4.2 表单Forms使用持久标签placeholder 只是示例不能充当标签。把格式要求与资格限制放在提交之前呈现而不是让用户提交后才撞墙。只有当“为什么要这个信息”不显然时才解释原因。必填与选填的视觉处理必须全产品一致。校验文案只说哪里需要注意、如何纠正不指责用户。相关说明紧贴对应字段放置并通过可访问的方式播报错误对应无障碍的 live region 播报。4.3 错误与权限Errors and permissions一条可执行的错误信息必须回答三个问题什么失败了what failed为什么——在已知且有用的前提下why, when known and useful如何恢复或还剩什么替代路径how to recover or what alternative remains。同时有两条禁令不要把内部错误码作为主消息暴露给用户不要承诺系统实际上无法知晓的原因或解决方案。对涉及隐私、支付、删除、权限丢失、工作被阻塞的场景要严肃对待——可以有温度但不可以有玩笑。4.4 加载、空态与成功状态Loading, empty, and success states加载文本要说出真实正在执行的操作并在等待有意义时给出诚实的预期能显示确定性进度就显示永远不要伪造进度。空态要区分四种本质不同的空首次使用、无搜索结果、被过滤器筛空、权限不足、失败——原文档列出的是 first use, no results, filters, permissions, and failure——并解释状态、提供下一个有用动作。成功态确认已完成的成果只有当“下一步后果”会改变用户该做什么时才提及其后影响例行成功应保持简短。4.5 帮助与指导性文本Help and instructional text辅助文本应回答一个隐含的问题而不是复述控件本身。不常用的细节使用渐进披露progressive disclosure不要平铺。链接文本必须脱离上下文也能看懂因为屏幕阅读器会单独朗读链接仅有图标的控件必须有可访问名称。5. 语气、无障碍与本地化clarify把语言质量拆成两层Voice语气底色保持一致tone语气随情境调节。用平实语言但不要抹平受众真正熟悉的术语。原文档给出的六条硬性约束是写完整可翻译的消息而不是靠运行时拼接碎片concatenated fragments变量与数字保持结构化让翻译者可以调整语序预留扩展空间不要过早缩写alt 文本要传达图片的信息装饰性图片用空 alt屏幕阅读器名称与可见标签、结果保持一致不要依赖标点、颜色或图标单独承载消息。最后一条配套建议当术语不一致跨产品存在时维护一份简短的术语表在界面里禁止为了文学效果而变化措辞——界面的语言稳定性优先于修辞。6. 验证改写完成的验收清单改写完不等于结束。clarify的 Verify 章节要求在上下文里通读整条流程并逐项测试八个维度不依赖隐藏产品知识即可理解comprehension without hidden product knowledge在错误、空态与决策点上的可执行性actionability事实准确性与术语一致性在目标宽度与 200% 缩放下的可扫读性scanability长名称、本地化扩展、复数变化与动态值可访问名称与状态变更的播报语气与后果及情绪情境相称。验收的收尾标准是一句话“最终文案要在不丢失含义或恢复路径的前提下尽可能短”as short as it can be without removing meaning or recovery。7. 与 audit、polish 的上下游衔接clarify在 impeccable 工作流中不是孤岛从源码结构看它与评测类、收尾类命令形成了明确的接力关系上游audit.md 与 critique 的报告格式都规定每条发现应给出“Suggested command”且允许的命令白名单中明确包含$impeccable clarify——即技术/UX 审计在发现文案问题时标准出口就是clarify。下游clarify.md 的最后一行规定当语言读起来干净了交接给$impeccable polish做最终一遍。polish.md 本身则定义了如何建立系统上下文、按优先级分诊并在整条路径上收尾是 impeccable “Fix → Refine” 两段式流程的收口。类似地harden.md负责错误处理、i18n 与边界情况的工程加固也以同样的 polish 交接收尾可以推断 impeccable 把“文案层”clarify与“工程层”harden视为互补的修复面二者最终都汇入同一个质量关口。8. 小结clarify 的方法论骨架把 clarify.md 的完整流程压缩成一句话先读整条路径做语言审计再为每个状态定四个问题事实、动作、上下文、语气然后按五种功能类型套用改写规则用本地化与无障碍六条约束守住语言质量底线最后用八项验证清单验收并交接给 polish。它把“UX 写作”从一种品味问题变成了一份可执行、可验收、可复用的工程规程——这也是 impeccable 作为“让 AI 代理更懂设计的语言包”在文案维度上的核心贡献。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Impeccable 的 clarify 命令详解：把含糊的界面文案改写成用户看得懂的 UX 文本
Impeccable 的 clarify 命令详解把含糊的界面文案改写成用户看得懂的 UX 文本【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableimpeccable 是一个面向 AI 编码代理的设计语言技能包其clarify命令专门解决“界面文案让用户看不懂”的问题识别含糊的标签、报错与提示按功能类型导航、表单、错误、状态、帮助文本系统性改写并输出可验证的验收清单。读完本文你将完整掌握clarify的审计方法、消息层级设定、五类界面文本的改写规则、本地化与无障碍约束以及它与audit、polish等命令在 impeccable 工作流中的衔接方式。1. clarify 在 impeccable 命令体系中的定位impeccable 技能通过一张命令表组织全部能力clarify被归类在Fix修复类别中命令类别描述参考文档clarify [target]Fix改进 UX 文案、标签和错误信息clarify.md这是 SKILL.md 中 Commands 表对clarify的完整定义。命令的参数提示为[target]即指定要改写的界面区域功能、页面或组件在 command-metadata.json 中它的触发描述进一步细化为当用户提到“文案令人困惑、标签不清晰、错误信息差、说明难以跟随或想要更好的 UX 写作”时使用。使用方式遵循 impeccable 的标准 Setup 流程每个会话先运行一次.agents/skills/impeccable/scripts/impeccable context该启动器会加载 PRODUCT.md、DESIGN.md、对应的界面简报以及如适用原生平台指引随后再加载clarify的参考文档执行改写。如果想为clarify建立独立快捷方式可以用 SKILL.md 中描述的 Pin 机制.agents/skills/impeccable/scripts/impeccable pin pin clarify生成独立的$clarify命令。若用户不带参数调用$impeccable技能会转入 routing.md 的上下文感知菜单只推荐不自动执行命令。值得注意的是impeccable 各 reference 文档的第一行都会声明该命令所需的“额外上下文”。clarify.md 开头即声明Additional context needed: audience knowledge and emotional state.额外所需上下文受众的知识水平与情绪状态。这意味着执行clarify时代理必须先弄清“读这些文案的人懂多少、处于什么情绪状态”再动手改写——这是整份 playbook 的第一性前提。2. 审计语言读整条交互路径而非孤立的字符串clarify的第一步不是改字而是审计。文档明确要求“读整条交互路径而不是孤立的字符串”Read the entire interaction path, not isolated strings并逐一识别以下八类语言问题含糊的名词、动词与动作ambiguous nouns, verbs, and actions内部黑话或默认用户已知的假设知识internal jargon or assumed knowledge含糊的标签、结果描述与系统状态vague labels, outcomes, and system states缺失的后果说明、恢复途径或时间预期missing consequences, recovery, or timing不一致的术语与大小写inconsistent terminology and capitalization冗余的标题、引言、辅助文本与确认提示redundant headings, intros, helper text, and confirmations在真实宽度下会断裂、或翻译后会出问题的文本text that breaks at realistic widths or in translation无视用户所处压力、风险、成功或紧迫情境的语气tone that ignores stress, risk, success, or urgency。完成审计后代理需要从产品上下文与周边 UI 推断受众与任务。同时有一条明确的边界在改动事实性声明、法律含义或可能是领域专用术语的词之前必须先向用户提问。这条规则防止 UX 改写越权改动产品语义——文案润色不能悄悄改变事实。3. 设定消息层级每个界面状态只回答四个问题审计完成后对每一个界面状态一个弹窗、一个错误页、一个空列表……依次决定四件事用户此刻需要知道的那一个事实the one fact the user needs now接下来可执行的动作the action available next会影响决策的支撑性上下文supporting context that changes the decision此刻恰当的语气the appropriate tone for this moment。配套的写作纪律只有一条但极其严格每个观点只说一次。如果标题已经把状态解释清楚了引言要么补充新信息要么直接删掉。这条规则直接对应审计清单中“冗余的标题、引言、辅助文本”这一项把“删冗余”从感觉变成可执行的判定标准。4. 按功能类型改写五类界面文本各自的规则clarify的核心是把改写规则按 UI 功能切分为五个子域。以下完整继承原文档的每类规则。4.1 动作与导航Actions and navigation当结果不显然时使用具体的动词 宾语标签应描述“会发生什么”而不是描述“触发它的手势”例如描述保存结果而不是写“点击此处”。全产品内同一概念保持同一套名词与动词禁止同义漂移。对破坏性操作文案必须点名操作对象与后果在恢复安全的前提下优先使用undo撤销代替确认对话框。确实需要确认时消息与按钮上都要写明动作本身而不是用Yes、No、OK、Submit这类无信息量的词。4.2 表单Forms使用持久标签placeholder 只是示例不能充当标签。把格式要求与资格限制放在提交之前呈现而不是让用户提交后才撞墙。只有当“为什么要这个信息”不显然时才解释原因。必填与选填的视觉处理必须全产品一致。校验文案只说哪里需要注意、如何纠正不指责用户。相关说明紧贴对应字段放置并通过可访问的方式播报错误对应无障碍的 live region 播报。4.3 错误与权限Errors and permissions一条可执行的错误信息必须回答三个问题什么失败了what failed为什么——在已知且有用的前提下why, when known and useful如何恢复或还剩什么替代路径how to recover or what alternative remains。同时有两条禁令不要把内部错误码作为主消息暴露给用户不要承诺系统实际上无法知晓的原因或解决方案。对涉及隐私、支付、删除、权限丢失、工作被阻塞的场景要严肃对待——可以有温度但不可以有玩笑。4.4 加载、空态与成功状态Loading, empty, and success states加载文本要说出真实正在执行的操作并在等待有意义时给出诚实的预期能显示确定性进度就显示永远不要伪造进度。空态要区分四种本质不同的空首次使用、无搜索结果、被过滤器筛空、权限不足、失败——原文档列出的是 first use, no results, filters, permissions, and failure——并解释状态、提供下一个有用动作。成功态确认已完成的成果只有当“下一步后果”会改变用户该做什么时才提及其后影响例行成功应保持简短。4.5 帮助与指导性文本Help and instructional text辅助文本应回答一个隐含的问题而不是复述控件本身。不常用的细节使用渐进披露progressive disclosure不要平铺。链接文本必须脱离上下文也能看懂因为屏幕阅读器会单独朗读链接仅有图标的控件必须有可访问名称。5. 语气、无障碍与本地化clarify把语言质量拆成两层Voice语气底色保持一致tone语气随情境调节。用平实语言但不要抹平受众真正熟悉的术语。原文档给出的六条硬性约束是写完整可翻译的消息而不是靠运行时拼接碎片concatenated fragments变量与数字保持结构化让翻译者可以调整语序预留扩展空间不要过早缩写alt 文本要传达图片的信息装饰性图片用空 alt屏幕阅读器名称与可见标签、结果保持一致不要依赖标点、颜色或图标单独承载消息。最后一条配套建议当术语不一致跨产品存在时维护一份简短的术语表在界面里禁止为了文学效果而变化措辞——界面的语言稳定性优先于修辞。6. 验证改写完成的验收清单改写完不等于结束。clarify的 Verify 章节要求在上下文里通读整条流程并逐项测试八个维度不依赖隐藏产品知识即可理解comprehension without hidden product knowledge在错误、空态与决策点上的可执行性actionability事实准确性与术语一致性在目标宽度与 200% 缩放下的可扫读性scanability长名称、本地化扩展、复数变化与动态值可访问名称与状态变更的播报语气与后果及情绪情境相称。验收的收尾标准是一句话“最终文案要在不丢失含义或恢复路径的前提下尽可能短”as short as it can be without removing meaning or recovery。7. 与 audit、polish 的上下游衔接clarify在 impeccable 工作流中不是孤岛从源码结构看它与评测类、收尾类命令形成了明确的接力关系上游audit.md 与 critique 的报告格式都规定每条发现应给出“Suggested command”且允许的命令白名单中明确包含$impeccable clarify——即技术/UX 审计在发现文案问题时标准出口就是clarify。下游clarify.md 的最后一行规定当语言读起来干净了交接给$impeccable polish做最终一遍。polish.md 本身则定义了如何建立系统上下文、按优先级分诊并在整条路径上收尾是 impeccable “Fix → Refine” 两段式流程的收口。类似地harden.md负责错误处理、i18n 与边界情况的工程加固也以同样的 polish 交接收尾可以推断 impeccable 把“文案层”clarify与“工程层”harden视为互补的修复面二者最终都汇入同一个质量关口。8. 小结clarify 的方法论骨架把 clarify.md 的完整流程压缩成一句话先读整条路径做语言审计再为每个状态定四个问题事实、动作、上下文、语气然后按五种功能类型套用改写规则用本地化与无障碍六条约束守住语言质量底线最后用八项验证清单验收并交接给 polish。它把“UX 写作”从一种品味问题变成了一份可执行、可验收、可复用的工程规程——这也是 impeccable 作为“让 AI 代理更懂设计的语言包”在文案维度上的核心贡献。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考