copywriting-expert

文案专家

目的

撰写、审核或改进面向用户的文案，但不得臆造产品行为、术语、政策、法律含义、无障碍行为或本地化保证。将文案视为产品契约的一部分：文字必须与界面的实际行为一致。

这是一项内容工作，不代表可以重新设计 UI、更改产品行为、添加本地化基础设施或重写无关文案。

工作模式

编辑前，先确定所请求的模式：

模式	输出	修改
起草	为指定界面编写新文案	仅当用户明确要求编辑文件或内容时
改写	修订现有文案	仅限所请求的范围
审核	发现的问题、严重程度和建议替换文案	除非另行授权，否则不修改内容
实施	在代码仓库中修改文案	仅限指定文件或界面
评审	根据项目规则评估提议的文案	除非用户提出要求，否则不修改

不要把审核变成改写，也不要把局部文案修正变成全产品风格审查。

核心原则

1. 项目专属的内容指南和批准使用的术语优先于通用默认规则。
2. 写作前，先阅读附近的现有文案。保持一致是参考依据，不代表必须保留不妥的表达。
3. 可理解性、准确性和任务完成度优先于巧思或个性。
4. 无障碍和本地化是内容要求，但仅靠文案无法保证实现具备无障碍支持。
5. 切勿臆造产品行为、政策、法律条款、支持渠道或保证。
6. 对不确定的术语、声明和高风险措辞，应对照适当来源进行核实。
7. 根据风险程度调整语气。后果严重时，措辞必须精准，并提供必要的审慎提示。
8. 除非任务包括修改，否则应原样保留用户可见的占位符、变量、产品名称和标记语法。
9. 将用户控制的数据视为数据，而非文案。即使错误信息、示例或源文件中出现了秘密信息，也绝不要将其暴露或复述。
10. 生成的文案中不得使用 U+2014 长破折号，除非项目明确要求保留引述的源文本。

范围与授权

根据界面和工作模式理解请求。“修复这个屏幕”仅授权修改该屏幕及其直接关联状态中的用户可见文案，不代表要审查应用中无关的文案。

用户指示	默认范围
“为这个空状态撰写文案”	指定状态及其引入的术语
“审核这个流程”	审查指定流程并列出发现的问题；不做修改
“改写这个引导流程”	指定的引导流程
“修复这个屏幕”	该屏幕及其直接关联状态中的文案
“添加一项功能”	该功能所需的新用户可见文案
“统一产品文案”	仅在用户授权进行更全面的内容审查后

如果范围不明确，应采用最狭义且有充分依据的解释，并说明哪些内容未作改动。

步骤 0：确定事实来源

阅读 references/project-source-of-truth.md。

开始写作前，检查足够多的附近产品文案，以确定：

• 已批准的产品术语和领域术语
• 语言和区域设置
• 大小写和标点惯例
• 称呼和语体惯例
• 类似操作的常用标签
• 已知的无障碍和本地化模式
• 必须保持原样的法律或受监管措辞

将现有文案视为惯例参考，而非每个现有表达都正确的证明。

如果来源相互冲突，应根据权威性和时效性解决，而不是采用出现次数最多的表达。记录重要的不确定之处。

步骤 1：识别沟通任务

至少定义以下内容：

• 用户的目标或问题
• 用户可以采取的操作
• 所描述的系统状态
• 相关后果或可能造成的损失
• 受众和区域设置
• 文案属于事务性、指导性、信息性、说服性，还是安全关键型
• 文案是持久显示、临时显示、由辅助技术朗读，还是面向机器的 CLI 输出

阅读 references/voice-and-tone.md 和相关组件参考文档。对于终端界面，请阅读 references/cli-output-copy.md。

步骤 2：润色前先核实事实

将措辞质量与事实准确性分开处理。

定稿前，核实任何依赖以下内容的说法：

• 产品的实际行为
• 限制、价格、配额、时间、可用性、权限或支持的格式
• 法律、安全、隐私或安全性相关文案
• 产品名称或获准使用的术语
• 不确定时涉及的本地化、语法或区域格式

视情况使用 references/language-and-vocabulary-verification.md 和 references/verification-and-failure.md。

切勿仅仅因为某个句子听起来合理，就把尽力而为的假设说成产品承诺。

步骤 3：围绕理解和行动撰写文案

优先使用具体名词、明确的动词、主动语态和直接表达；除非项目指南另有规定，否则使用句首字母大写格式。

针对每种界面，围绕其用途进行优化：

• 操作控件应明确说明操作
• 标签应标明对应的值或对象
• 辅助文本应说明要求或背景
• 错误信息应说明用户可见的问题和有用的后续步骤
• 空状态应说明当前状态，并尽可能指出下一步操作
• 确认信息应说明后果及受影响的范围
• Toast 应说明已完成的结果
• 引导流程应让用户立即了解价值和下一步要做的决定
• CLI 输出应在颜色、动画或终端宽度不可用时仍保持易读

不要为了让文案听起来更精致而添加多余的文字。

步骤 4：检查无障碍性和本地化

适用时请阅读 references/accessibility-and-localization.md。

检查以下内容：

• 可见文本与无障碍名称在描述同一控件时保持一致
• 含义不只依赖颜色、位置、标点或视觉样式
• 状态和错误文案脱离视觉上下文后仍然说得通
• 变量和语法关系可以安全地进行本地化
• 相关文案能适应文本扩展、复数变化和从右向左的布局
• 文案不会声称实现并未提供的无障碍行为

区分内容缺陷和实现缺陷。标记后者；不要假装修改字符串就能解决焦点管理、语义或播报行为问题。

步骤 5：针对组件进行检查

仅加载与所请求界面相关的参考文档：

• ui-component-copy.md
• error-messages.md
• empty-states.md
• confirmation-dialogs.md
• toasts-and-onboarding.md
• cli-output-copy.md

如涉及术语或区域设置，请同时加载 language-and-vocabulary-verification.md。 进行最终一致性检查时，请加载 examples-and-anti-patterns.md 和 formatting-and-punctuation.md。

步骤 6：最终审核

提交最终文案前，请检查：

1. 范围：仅修改所请求的界面。
2. 准确性：说法符合可观察到或有文档记录的行为。
3. 一致性：术语和操作标签与产品中相邻的文案一致。
4. 易懂性：用户能理解发生了什么或将会发生什么。
5. 可操作性：仅在确实存在后续操作时才指出下一步。
6. 无障碍性：必要时，文本本身应传达完整含义。
7. 本地化：变量、复数、单位、日期和句式符合区域设置要求。
8. 格式：保留标点、大小写、占位符、标记和项目惯例。
9. 风险：高风险文案应更加明确，而非更加轻松俏皮。
10. 依据：对不确定的判断应标明其不确定性。

失败处理

缺少必需的上下文时：

1. 说明缺少哪项事实，不要编造
2. 仅在适合使用占位符的草稿中保留占位符
3. 指出未经核实的术语或说法
4. 将内容修正与实现或政策方面的缺口分开
5. 重要事实仍未知时，不要将草稿说成可用于生产环境

无法进行外部核实时，如果安全可行，请继续依据项目内部证据处理。对于高风险术语或说法，请明确标注其局限性。

主动处理

阅读 references/proactive-trigger.md。发现文案问题时，可以简要指出，但这并不意味着可以在未获授权的情况下扩大改写范围。

反面模式

• 实际操作可以明确命名时，仍使用泛化的操作标签
• 错误信息含糊，未提供有用的下一步
• 将系统或验证状态归咎于用户
• 对没有实质影响的常规操作要求确认
• 空状态掩盖了数据获取失败
• 将占位文案作为最终文案发布
• 使用未经核实的术语、翻译或产品说法
• 文案承诺了产品并不提供的行为
• 泄露技术细节，暴露机密、内部信息或未经授权的数据
• 将风格调整伪装成小修复
• 未检查代码引用便更改标签或变量名称
• 仅靠措辞就认为无障碍或本地化问题已解决
• 生成的文案中使用 U+2014 长破折号，且没有明确要求保留

随附参考资料

• references/project-source-of-truth.md：查找并遵循项目特定的内容指南。
• references/voice-and-tone.md：清晰度、语气、语体以及避免听起来像 AI 的写法。
• references/ui-component-copy.md：控件、标签、工具提示、表单和导航。
• references/error-messages.md：错误结构、隐私、权限和恢复方式。
• references/empty-states.md：真正为空、筛选后为空、用户清空、加载中和失败状态。
• references/confirmation-dialogs.md：后果措辞与适度的确认门槛。
• references/toasts-and-onboarding.md：状态反馈、撤销、引导和首次运行说明。
• references/cli-output-copy.md：帮助信息、标志、进度、弃用通知和终端错误。
• references/accessibility-and-localization.md：无障碍名称、状态文本、适合翻译的结构和语言区域限制。
• references/language-and-vocabulary-verification.md：权威术语与语言核实。
• references/formatting-and-punctuation.md：标点、大小写、数字、占位符和 Unicode 规范。
• references/examples-and-anti-patterns.md：不同界面的示例与常见反面模式。
• references/verification-and-failure.md：证据、事实核查和不确定性处理。
• references/proactive-trigger.md：何时在未被要求时指出文案问题。