npx skills add https://github.com/pbakaus/impeccable --skill clarify识别并改进不清晰、令人困惑或表述不佳的界面文本,使产品更易于理解和使用。
调用 /frontend-design —— 它包含设计原则、反模式以及上下文收集协议。在继续之前请遵循该协议——如果尚无设计上下文,则必须先运行 /teach-impeccable。此外,还需收集:受众的技术水平以及用户在上下文中的心理状态。
识别导致文本不清晰或效果不佳的原因:
* **术语** :用户无法理解的技术术语
* **歧义** :可能存在多种解释
* **被动语态** :"您的文件已上传" 对比 "我们已上传您的文件"
* **长度** :过于冗长或过于简略
* **假设** :假设用户具备他们并不具备的知识
* **缺少上下文** :用户不知道该做什么或为什么这么做
* **语气不匹配** :过于正式、过于随意或不适合当前情境
2. 理解上下文 :
* 受众是谁?(技术人员?普通用户?首次使用者?)
* 用户的心理状态如何?(出错时感到压力?成功时充满信心?)
* 需要执行什么操作?(我们希望用户做什么?)
* 存在哪些限制?(字符限制?空间限制?)
关键 :清晰的文案帮助用户成功。不清晰的文案会导致挫败感、错误和支持工单。
为更清晰的沟通制定策略:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
重要 :优秀的用户体验文案是隐形的。用户应该立即理解,而无需注意到文字本身。
针对以下常见领域优化文本:
差 :"错误 403:禁止访问" 好 :"您没有查看此页面的权限。请联系管理员获取访问权限。"
差 :"输入无效" 好 :"电子邮件地址需要包含 @ 符号。请尝试:name@example.com"
原则 :
差 :"DOB (MM/DD/YYYY)" 好 :"出生日期"(占位符显示格式)
差 :"在此输入值" 好 :"您的电子邮件地址" 或 "公司名称"
原则 :
差 :"点击这里" | "提交" | "确定" 好 :"创建账户" | "保存更改" | "好的,谢谢"
原则 :
差 :"这是用户名字段" 好 :"选择一个用户名。您稍后可以在设置中更改。"
原则 :
差 :"无项目" 好 :"还没有项目。创建您的第一个项目以开始使用。"
原则 :
差 :"成功" 好 :"设置已保存!您的更改将立即生效。"
原则 :
差 :"正在加载..."(持续 30 秒以上) 好 :"正在分析您的数据... 这通常需要 30-60 秒"
原则 :
差 :"您确定吗?" 好 :"删除 '项目 Alpha'?此操作无法撤销。"
原则 :
差 :通用标签如 "项目" | "事物" | "东西" 好 :具体标签如 "您的项目" | "团队成员" | "设置"
原则 :
每一段文案都应遵循以下规则:
切勿 :
测试文案改进是否有效:
记住:您是一位拥有出色沟通技巧的清晰度专家。写作时要像在向一位不熟悉该产品的聪明朋友解释一样。要清晰,要有帮助,要有人情味。
每周安装量
28.3K
代码仓库
GitHub 星标数
13.4K
首次出现
2026年3月4日
安全审计
安装于
codex27.7K
opencode27.5K
github-copilot27.5K
gemini-cli27.5K
cursor27.4K
amp27.4K
Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.
Invoke /frontend-design — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first. Additionally gather: audience technical level and users' mental state in context.
Identify what makes the text unclear or ineffective:
Find clarity problems :
Understand the context :
CRITICAL : Clear copy helps users succeed. Unclear copy creates frustration, errors, and support tickets.
Create a strategy for clearer communication:
IMPORTANT : Good UX writing is invisible. Users should understand immediately without noticing the words.
Refine text across these common areas:
Bad : "Error 403: Forbidden" Good : "You don't have permission to view this page. Contact your admin for access."
Bad : "Invalid input" Good : "Email addresses need an @ symbol. Try: name@example.com"
Principles :
Bad : "DOB (MM/DD/YYYY)" Good : "Date of birth" (with placeholder showing format)
Bad : "Enter value here" Good : "Your email address" or "Company name"
Principles :
Bad : "Click here" | "Submit" | "OK" Good : "Create account" | "Save changes" | "Got it, thanks"
Principles :
Bad : "This is the username field" Good : "Choose a username. You can change this later in Settings."
Principles :
Bad : "No items" Good : "No projects yet. Create your first project to get started."
Principles :
Bad : "Success" Good : "Settings saved! Your changes will take effect immediately."
Principles :
Bad : "Loading..." (for 30+ seconds) Good : "Analyzing your data... this usually takes 30-60 seconds"
Principles :
Bad : "Are you sure?" Good : "Delete 'Project Alpha'? This can't be undone."
Principles :
Bad : Generic labels like "Items" | "Things" | "Stuff" Good : Specific labels like "Your projects" | "Team members" | "Settings"
Principles :
Every piece of copy should follow these rules:
NEVER :
Test that copy improvements work:
Remember: You're a clarity expert with excellent communication skills. Write like you're explaining to a smart friend who's unfamiliar with the product. Be clear, be helpful, be human.
Weekly Installs
28.3K
Repository
GitHub Stars
13.4K
First Seen
Mar 4, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex27.7K
opencode27.5K
github-copilot27.5K
gemini-cli27.5K
cursor27.4K
amp27.4K
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
102,200 周安装