用途
Brand Guidelines 用于按照 Sentry 的品牌规范撰写或改写面向用户的文案。当任务涉及 Sentry 语气的用户可见文字,或涉及界面文本、引导流程、空状态、文档、营销文案等品牌内容时适用,也可用于判断何时该用 Plain Speech、何时该用 Sentry Voice。
语调选择
技能要求先根据语境选择语调:
- 使用 Plain Speech:产品界面(按钮、标签、表单)、文档、错误消息、设置页面、事务性邮件、帮助文本。
- 使用 Sentry Voice:404 页面、空状态、引导流程、加载状态、“What's New” 公告、营销文案。
默认使用 Plain Speech,除非语境明确需要体现个性。
Plain Speech(默认)
Plain Speech 清晰、直接、功能导向,用于大多数界面元素。其规则包括:简洁,用尽可能少的词;直接,告诉用户要做什么,而不是他们能做什么;使用主动语态(“Save your changes” 而非 “Your changes will be saved”);避免术语;具体(“3 errors found” 而非 “Some errors found”)。示例包括:把 “Click here to save your changes” 改为 “Save”;“You can filter results by date” 改为 “Filter by date”;“An error has occurred” 改为 “Something went wrong”;“Please enter a valid email address” 改为 “Enter a valid email”;“Are you sure you want to delete?” 改为 “Delete this item?”。
Sentry Voice
Sentry Voice 在合适时刻加入个性,特点是共情式调侃、有自知之明、偶尔带点讽刺。原则包括:把挫败感指向情境而非用户;承认软件的荒诞;有趣但不影响功能;只在用户有时间欣赏时使用。示例包括 404 页面:“This page doesn't exist. Maybe it never did. Maybe it was a dream. Either way, let's get you back on track.”;空状态:“No errors yet. Enjoy this moment of peace while it lasts.”;引导流程:“Let's get your first error. Don't worry, it's not as scary as it sounds.”;加载状态:“Crunching the numbers...”“Fetching your data...”。
不适合使用 Sentry Voice 的场景:错误消息(用户正在受挫)、设置页面(用户专注)、文档(用户需要信息)、账单/支付流程(用户需要信任)。
通用规则
拼写与语法:使用美式英语拼写(color 而非 colour);标题和页面标题使用 Title Case;正文、按钮和标签使用 Sentence case。
标点:界面文本不用感叹号(庆祝时刻例外);短界面标签或按钮文本不加句号;完整句子和帮助文本使用句号;除缩写(API、SDK、URL)外不使用全大写。
用词偏好:省略 “Please”;不用 “Sorry”,改为具体说明问题;不用 “Error occurred”,改为 “Something went wrong”;不用 “Invalid”,改为说明哪里不对;不用 “Success!”,改为描述发生了什么;不用 “Oops”,改为具体说明。
破折号:连字符(-)用于复合词、范围,如 “real-time”“1-10”;短破折号(--)用于范围、关系,如 “2023--2024”“parent--child”;长破折号(---)用于打断、强调,如 “Errors---even small ones---matter”。多数界面语境使用连字符,短破折号用于日期范围,长破折号用于较长散文。
界面元素指引
按钮:使用动作动词(“Save”“Delete”“Create”);具体化(“Create Project” 而非仅 “Create”);尽量控制在 2-3 个词;不加句号或感叹号。
错误消息:说明发生了什么;如有帮助说明原因;说明下一步怎么做。好例子:“Could not save changes. Check your connection and try again.” 坏例子:“Error: Save failed.”
空状态:说明这里通常会出现什么;提供明确操作以填充该状态;此处适合使用 Sentry Voice。好例子:“No projects yet. Create your first project to start tracking errors.”
确认对话框:在标题中让操作清晰;若有破坏性,说明后果;使用具体按钮标签(“Delete Project” 而非 “OK”)。
提示与帮助文本:保持在两句以内;解释“为什么”而不只是“是什么”;复杂话题链接到文档。
反模式
应避免:机器腔(“Item has been successfully deleted” 改为 “Deleted”);被动语态(“Changes were saved” 改为 “Changes saved”);冗余措辞(“In order to” 改为 “To”);模糊措辞(“This might cause...” 改为 “This will cause...”);双重否定(“Not unlike...” 改为 “Similar to...”);界面中的营销腔(“Supercharge your workflow” 改为 “Speed up your workflow”)。
限制
仅在任务明确匹配上述范围时使用该技能。不应将输出视为针对特定环境验证、测试或专家评审的替代。若缺少必需输入、权限、安全边界或成功标准,应停止并请求澄清。