npx skills add https://github.com/getsentry/skills --skill brand-guidelines遵循 Sentry 的品牌指南撰写面向用户的文案。
根据上下文选择合适的语气:
| 使用平实语言 | 使用 Sentry 语气 |
|---|---|
| 产品 UI(按钮、标签、表单) | 404 页面 |
| 文档 | 空状态 |
| 错误信息 | 引导流程 |
| 设置页面 | 加载状态 |
| 事务性邮件 | "最新动态" 公告 |
| 帮助文本 | 营销文案 |
默认使用平实语言,除非上下文特别需要体现个性。
平实语言清晰、直接且实用。适用于大多数 UI 元素。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 避免使用 | 应写作 |
|---|---|
| "点击此处保存更改" | "保存" |
| "您可以按日期筛选结果" | "按日期筛选" |
| "发生错误" | "出错了" |
| "请输入有效的电子邮件地址" | "输入有效的电子邮件" |
| "您确定要删除吗?" | "删除此项?" |
Sentry 语气在适当的时刻增添个性。它富有同理心、有自知之明,偶尔带点讽刺。
404 页面:
"此页面不存在。也许它从未存在过。也许它只是一场梦。无论如何,让我们帮你回到正轨。"
空状态:
"暂无错误。享受这片刻的宁静吧。"
引导流程:
"让我们来捕获你的第一个错误。别担心,没听起来那么可怕。"
加载状态:
"正在处理数据..." "正在获取你的数据..."
| 避免使用 | 推荐使用 |
|---|---|
| 请 | (省略) |
| 抱歉 | (具体说明问题所在) |
| 发生错误 | 出错了 |
| 无效 | (解释哪里不对) |
| 成功! | (描述发生了什么) |
| 哎呀 | (具体说明) |
| 类型 | 用途 | 示例 |
|---|---|---|
| 连字符 (-) | 复合词、范围 | "real-time"、"1-10" |
| 短破折号 (--) | 范围、关系 | "2023--2024"、"parent--child" |
| 长破折号 (---) | 中断、强调 | "Errors---even small ones---matter" |
在大多数 UI 上下文中,使用连字符。短破折号保留用于日期范围,长破折号用于较长的叙述性文字。
好的示例: "无法保存更改。请检查网络连接后重试。" 差的示例: "错误:保存失败。"
好的示例: "暂无项目。创建你的第一个项目以开始追踪错误。"
避免以下常见错误:
每周安装量
260
代码仓库
GitHub 星标数
454
首次出现
2026 年 1 月 24 日
安全审计
安装于
gemini-cli223
opencode222
claude-code222
codex220
github-copilot214
cursor210
Write user-facing copy following Sentry's brand guidelines.
Choose the appropriate tone based on context:
| Use Plain Speech | Use Sentry Voice |
|---|---|
| Product UI (buttons, labels, forms) | 404 pages |
| Documentation | Empty states |
| Error messages | Onboarding flows |
| Settings pages | Loading states |
| Transactional emails | "What's New" announcements |
| Help text | Marketing copy |
Default to Plain Speech unless the context specifically calls for personality.
Plain Speech is clear, direct, and functional. Use it for most UI elements.
| Instead of | Write |
|---|---|
| "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 adds personality in appropriate moments. It's empathetic, self-aware, and occasionally snarky.
404 Pages:
"This page doesn't exist. Maybe it never did. Maybe it was a dream. Either way, let's get you back on track."
Empty States:
"No errors yet. Enjoy this moment of peace while it lasts."
Onboarding:
"Let's get your first error. Don't worry, it's not as scary as it sounds."
Loading States:
"Crunching the numbers..." "Fetching your data..."
| Avoid | Prefer |
|---|---|
| Please | (omit) |
| Sorry | (be specific about the problem) |
| Error occurred | Something went wrong |
| Invalid | (explain what's wrong) |
| Success! | (describe what happened) |
| Oops | (be specific) |
| Type | Use | Example |
|---|---|---|
| Hyphen (-) | Compound words, ranges | "real-time", "1-10" |
| En-dash (--) | Ranges, relationships | "2023--2024", "parent--child" |
| Em-dash (---) | Interruption, emphasis | "Errors---even small ones---matter" |
In most UI contexts, use hyphens. Reserve en-dashes for date ranges and em-dashes for longer prose.
Good: "Could not save changes. Check your connection and try again." Bad: "Error: Save failed."
Good: "No projects yet. Create your first project to start tracking errors."
Avoid these common mistakes:
Weekly Installs
260
Repository
GitHub Stars
454
First Seen
Jan 24, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
gemini-cli223
opencode222
claude-code222
codex220
github-copilot214
cursor210
注册流程转化率优化指南:减少摩擦、提高完成率的专家技巧
25,700 周安装