关于 clarify
clarify 是 ui-craft 的文案审查子技能,面向检查界面文案的设计与开发工作。它按固定清单找出问题,默认提供修改建议而不直接编辑。
主要功能
- 01检查按钮、错误和空状态文案
- 02审查表单提示与确认语
- 03检查破坏性操作按钮措辞
- 04检查大小写、语态与用词
- 05以对照表呈现修改建议
适用场景
- 01审查界面文案是否清晰可操作
- 02检查错误信息是否说明后续步骤
- 03在用户要求时应用文案修改
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ educlopez/ ui-craft --skill clarify安装后在 Claude Code 中输入/clarify确认已加载。
详细介绍
**上下文:**此子技能是更广泛的 ui-craft 技能的一个视角。如果也安装了 ui-craft 技能,请先阅读其 SKILL.md,了解 Discovery + Anti-Slop + Craft Test,然后再应用以下特定视角。
澄清 $ARGUMENTS 中的文案。加载 ui-craft 技能。
**默认模式:评审,而非编辑。**以评审格式表格返回文案差异。只有用户说“apply”时才应用更改。
检查清单 — 浏览 UI 并标记每一处问题:
- 按钮标签 — 动词 + 对象。“发送邀请”优于“提交”。“删除项目”优于“删除”。绝不使用“确定”“提交”“点击此处”。
- 错误提示 — 内联、具体、可操作。“电子邮件地址已被使用 — 请登录或使用其他地址。”绝不使用“出了点问题。”
- 空状态 — 用一行说明为空的原因 + 一个 CTA。“目前还没有项目。创建第一个项目。”而不是“这里空空如也!”
- 表单提示 — 显示在字段下方,始终可见,而不只是触发验证后才显示。“必须包含数字和符号”应作为辅助文本,而不是提交后才显示的错误。
- 确认文案 — 使用过去时,主体置前。“项目已删除。”优于“已成功删除项目。”
- 破坏性操作 — 按钮中要包含对象。“删除 {projectName}”优于“删除”。对话框负责确认;按钮负责执行。
- 大小写 — 默认使用句子式大小写。仅品牌产品名称使用标题式大小写。绝不使用全大写(例外:SKILL.md 中已有说明的 11-13px 分类标签)。
- 语气 — 清晰胜过巧妙。使用主动语态。句子简短。用常见词语(用“取消”而非“终止”,用“开始”而非“启动”)。
与旋钮无关 — 清晰度不可调节。无论 CRAFT_LEVEL 如何,都要执行完整检查清单。
需要阅读的参考资料:references/copy.md(微文案语气 + 模式)、references/accessibility.md(屏幕阅读器对错误消息的要求)。
输出格式 — 评审格式表格:
| 修改前 | 修改后 | 原因 |
|---|
按影响程度排序(先处理错误和破坏性操作,再处理 CTA,最后处理辅助文案)。最后用一段话总结整体语气的变化。如果用户说“apply”,请编辑代码,并重新打印附带文件路径的表格。
下一步:/critique — 文案更改会影响层级;之后重新检查界面(第 1 阶段)。
评论
支持 Markdown