clarify

clarify skill 概览

clarify skill 是做什么的

clarify skill 用来把让人困惑的 UX 文案改写成用户真正能采取行动的表达。它尤其适合处理含糊不清的标签、报错信息、引导步骤、空状态、表单提示，以及那些让人看完仍然不知道下一步该做什么的说明。如果你想把 clarify 用在 Technical Writing 场景，这个 skill 的目标就是让文案更直接、更具体，也更易于快速扫读。

谁适合使用它

当你在为真实用户打磨产品文案时，就适合使用这个 clarify skill，尤其是在目标用户处于压力大、时间紧，或技术背景不深的情况下。它很适合支持内容、界面文案审查，以及那些希望在不改动底层产品的前提下减少用户困惑的产品团队。

它的不同之处

它的核心价值不只是“帮我重写一下”。这个 skill 会先推动你判断上下文：用户的技术水平、用户当下的心理状态，以及这段文案希望触发什么动作。正因为如此，它的输出会比通用 prompt 更实用——它把清晰度当作一个决策问题，而不只是措辞问题。

如何使用 clarify skill

安装并找到源码

使用 npx skills add pbakaus/impeccable --skill clarify 安装 clarify skill。安装后先打开 SKILL.md，因为这里面包含了完整工作流以及必须先做的准备步骤。这个仓库没有额外的辅助文件，因此最主要、最权威的信息来源就是 skill 本体内容。

给 clarify skill 正确的输入

想获得更好的 clarify usage 效果，起点一定是明确的目标，而不是模糊要求。好的输入会说明文本类型、受众和使用情境，例如：

• “Clarify these checkout error messages for first-time shoppers who may be anxious.”
• “Rewrite these admin labels for internal support agents using a SaaS dashboard.”
• “Improve this setup flow copy for technical writers reviewing onboarding instructions.”

像“make this clearer”这种过于宽泛的输入，会迫使模型自行脑补上下文，结果通常只会产出泛泛而谈的文案。

按照“上下文优先”的工作流来用

这个 skill 预期你在改写前先收集设计上下文。实际使用时，最好一并提供：

1. 需要优化的原始文案。
2. 这段文案出现于产品的哪个位置。
3. 谁会看到它，他们当时想完成什么。
4. 如果是报错或失败场景，用户当下的情绪状态。
5. 任何限制条件，例如字数限制、品牌语气或本地化需求。

这些上下文信息，才是让 clarify skill 从“润色工具”变成真正可用的编辑工具的关键。

优先看最关键的部分

如果你想快速掌握 clarify guide，建议先读 SKILL.md 里这几个主题附近的内容：当前文案评估、上下文收集、系统化改进。这些部分展示了 skill 如何判断“哪里不清楚”，以及应当如何修改。如果你只能扫一遍，请优先看准备步骤和评估逻辑，再开始写 prompt。

clarify skill 常见问题

clarify 只是一个通用改写 prompt 吗？

不是。clarify skill 之所以比通用 prompt 更有用，是因为它要求你在改写前先明确受众、目标动作和用户状态。对于那些不仅要“读起来顺”，更要帮助用户理解并完成操作的文案来说，这一点非常重要。

clarify 适合 Technical Writing 吗？

适合，尤其是在 Technical Writing 与 UI 文案、操作说明、帮助文本或面向产品用户的文档发生交叉时。它更擅长优化面向用户的小块文本，而不是处理长篇文档写作。

什么情况下不该用 clarify？

当问题根本不在“清晰度”上时，就不该用它。如果问题出在产品逻辑、功能缺失或流程本身有问题，再好的文案也补不上。另一个不太适合的情况是：你需要的是完整的品牌 voice 打造，而不是针对性的 UX 文案优化。

我不是文案人员，也能把它用好吗？

可以。只要你能提供它所要求的上下文，这个 skill 对新手也很友好。相比费力把 prompt 写得“像高手”，带上示例、限制条件和期望用户动作，往往更能得到更好的 clarify usage 结果。

如何改进 clarify skill 的使用效果

提供更好的原始材料

质量提升最大的来源，通常就是输入更完整。尽量提供准确原文、所在页面或界面上下文，以及一两个你期望的语气示例。如果当前文案之所以失败有明确原因，也请直接说清楚：比如太模糊、太正式、太长、太技术化，或者步骤太多。

明确用户的心理状态

这个 skill 最强的信号之一，就是用户当下是平静、困惑、沮丧，还是刚从报错中恢复。尽早把这点告诉模型。比如：“This appears after a failed payment and the user may be anxious.” 这样更容易得到兼顾同理心和可执行性的改写方案。

让修改直接解决真实问题

如果当前文案的问题在于隐藏了下一步操作，就明确要求给出更清晰的 call to action；如果问题在于术语太多，就要求提供 plain language 替代表达；如果问题在于信息过密，就要求更短的版本。这样能让 clarify skill 始终聚焦在真正的问题上，而不是产出只是“看起来更漂亮”的表面修改。

带着约束去复核并迭代

第一轮输出后，检查改写后的文案是否仍然符合 UI 空间、目标受众以及产品术语体系。然后再根据约束继续细化，比如更短的字符数、更正式的语气，或更高的具体性。迭代很重要，因为清晰度往往不是靠“多给几个版本”提升的，而是靠你把 prompt 逐步收紧。