Alephic 写作风格指南
Brand
Colors
Images
Linear
Logos
Remote
Slack
Talent
Writing
写作
上次更新：2025 年 5 月 2 日
我们的写作理念
在 Alephic，写作是我们实现清晰表达和有效说服的首要工具。文字能够展现我们的思考方式，证明我们的专业知识，并与客户建立信任。本风格指南旨在帮助我们保持一致的写作风格，在体现深厚知识底蕴的同时，兼顾易于理解。
核心写作原则
1. 行文有力且简洁
一句话不应包含不必要的词语，一段文字不应包含不必要的句子——正如一幅画不应有多余的线条，一台机器不应有多余的零件。 — Strunk & White
- 要言不烦。 删除任何没有实际作用的词语、句子或段落。（如果你的目光在重读时轻易掠过某行，那一行就应该删掉。）
- 点到为止。 冗余会模糊洞察力，简洁则能提升洞察力。
- 无情删减，反复删减。 在点击“发布”之前，快速浏览一遍文章——任何在不推进论点的情况下跳出来的短语都是多余的。删掉它。
记住：简洁并不意味着简短。我们欢迎深度——但每句话都必须发挥作用。
2. 使用主动语态
- 以执行者开头。 将行为者置于行动之前：“AI 改变了营销”，而不是“营销被 AI 改变了”。
- 默认使用主谓宾结构。 主动结构使句子简短、直接且充满活力。（当行为者未知_或_无关紧要时，可以使用被动语态——但要明智地使用，而不是偷懒。）
- 让动词承担重任。 优先选择“我们构建了一个实时仪表盘”而不是“一个实时仪表盘被构建”。强有力的动词可以明确责任并加快理解。
3. 具体且实在
- 用数字说话。 将每个主张都建立在数据_和_背景之上：“美国官僚机构的成本约为 3 万亿美元——约占 2016 年 GDP 的 17%”，优于“官僚机构成本高昂”。
- 指明你的证据。 引用数据集，引用专家，并链接到研究。具体的来源可以立即建立可信度。
- 用例子代替抽象概念。 尽可能用读者可以想象得到的具体公司、项目或指标来代替“组织经常……”
4. 结构清晰
- 每段一个观点。 以主题句开头；让每个段落推进一个步骤。
- 标明层级结构。 使用清晰的标题（H2 → H3 → H4），以便读者在阅读文字之前能够快速了解文章的整体结构。
- 留出空间让文本呼吸。 将密集的文本块分解为短段落，并增加有意的空白。
我们的声音
我们的声音平衡了三个关键品质：
1. 智识上的大胆
我们挑战传统思维，建立意想不到的联系，并提供新鲜的视角。
应该| 不应该 ---|--- 从第一性原理思考| 重复别人都在说的话 从不同的参考文献和领域中汲取灵感| 局限于营销术语 将智力概念与实际应用联系起来| 为了复杂而追求复杂 使用清晰的框架来组织你的想法| 没有结构地呈现想法
示例：
在 AI、代码和营销专业知识的交汇处，我们创造了昨天不可能，明天将司空见惯的解决方案。
2. 雄心勃勃且脚踏实地
我们描绘变革性变化的愿景，同时始终将一只脚牢牢地放在现实中。
应该| 不应该 ---|--- 承认 AI 影响的巨大程度| 过度炒作超出当前可能性的能力 关注战略性的长期影响| 迷失在战术细节中 展示未来，而不仅仅是描述它| 在没有证据或例子的情况下提出主张 将愿景与实际成果联系起来| 提出没有实施路径的想法
示例：
这仅仅是个开始。即使这些模型永远不会比我们今天拥有的更好，仍然有 10 年的运营空间来实现它们。
3. 极其简单
我们以清晰和自信的方式呈现复杂的想法，去除所有不必要的元素。
应该| 不应该 ---|--- 将复杂的概念分解为清晰的组成部分| 在没有解释的情况下使用术语 一次按逻辑顺序呈现一个想法| 用多个概念超载句子 精确和经济地使用语言| 添加不必要的修饰语（“非常”、“相当”） 大声朗读你的作品来测试自然的流畅性| 以一种口语化时听起来很生硬的方式写作
示例：
借助 AI，不可能的问题变得仅仅困难，困难的问题变得容易，容易的问题变得微不足道。所有的乐趣都在于扩展可能性的边界。
语调特征
我们的写作应该让人感觉：
随和
以一种随意的态度保持严肃和聪明。写作时要像一个乐观、兴奋的人，分享你真正关心的想法。避免制造距离感的公司术语和行话。
深思熟虑
将你的写作建立在深思熟虑的分析之上。如果我们把未来押在比竞争对手更好地理解市场之上，那么我们所写的一切都应该体现真正的思考。
清晰简洁
聪明并不意味着冗长。尽可能少用词。拥有良好的词汇量，但要保持简单，以帮助他人理解我们的愿景。阅读你的写作，并澄清任何别人第一次阅读时可能不理解的内容。
大胆
发表有力的声明，将我们定位为领导者和专家，但始终准备好用证据来支持它们。大胆并不意味着消极——对行业保持兴奋，对未来保持乐观。
文档编写最佳实践
我们的文档编写方法包含以下关键原则：
1. 适合上下文
确定你要编写的文档类型：
- 教程（Tutorials） - 面向初学者的学习型指导
- 操作指南（How-to guides） - 针对特定问题的任务型指导
- 参考资料（Reference material） - 面向信息的技术描述
- 解释（Explanations） - 面向理解的概念讨论
2. 编写清晰且切中要点
切入主题。阐明你的观点。迅速结束。
3. 尽可能使用视觉元素
利用图表、屏幕截图、图表和其他视觉辅助工具来阐明复杂的概念。对于软件文档，当静态图像不足以说明问题时，使用动画 GIF 或视频。
4. 可浏览
构建内容以帮助读者识别和跳过熟悉的概念。使用标题、链接、列表、段落和粗体使你的文档可扫描。
5. 保持最新
过时的文档造成的危害比没有文档更大。设置定期检查日期，尽可能拆分文档以最大限度地减少更新需求，并创建反馈渠道。
6. 易于发现
确保你的文档易于查找、正确分类且可共享。将文档视为我们共享的组织记忆的关键组成部分。
编辑流程
与 AI 协作
AI 是我们的创意副驾驶，而不是自动驾驶仪。我们用语言模型来起草、概述或集思广益，但在分享之前，务必阅读和提炼 AI 的输出。传递你没有读过的文字是不礼貌的。
- 逐行审查。 永远不要转发原始的 AI 输出。大声朗读并提炼语音，使其感觉无疑是你自己的。
- 验证事实和来源。 在你确认模型生成的参考文献之前，将其视为未经验证的。
- 拥有署名权。 只发布你自豪地签名的内容——AI 可以协助，但你拥有最终版本。
HAL 9000 规则
对不起，Dave，恐怕我不能让你编辑那个。 — 2001: 太空漫游（意译）
最后，也是最重要的一点，不要让 AI（或任何编辑器）从写作中移除_你_。Grammarly 或 ChatGPT 的自然愿望是遵循最佳实践。伟大的作家有他们自己的风格，并且对此感到舒适。这并不意味着你可以打破基本的语法规则（尽管有时你可以），但要注意这些工具可能对使你与众不同的事物产生的扁平化效应。仅仅因为机器告诉你这样做并不意味着你必须这样做。
四个问题的测试
在编辑文档时，问自己：
- 是否清晰？ 我是否明确地阐明了我的观点？
- 是否简洁？ 我是否使用了超过必要的词语？
- 是否有洞察力？ 我是否带来了新的想法？
- 是否引人入胜？ 如果我要求读者采取行动，他们为什么要这样做？
“洛城故事测试”
在 1991 年的电影 L.A. Story 中，Trudi 提出了她的“七点珠宝”规则：外出时佩戴的“点数”永远不要超过七个（耳环算作两个，项链一个，等等）。在出门之前，她在镜子前旋转——第一个吸引她眼球的物品会被移除。
将同样的无情极简主义应用于散文。在你的最后一次通读中，快速浏览文章；任何跳出来但没有推进论点的短语、句子、段落或部分都是多余的。删掉它。
在你出门之前，照照镜子，快速转过身来，第一个吸引你眼球的东西——扔掉它。 — L.A. Story (1991)
“模糊的眼睛”测试
当你在编辑时发现自己跳过某个句子或段落时，你就找到了应该删除的地方。
六步流程
- 草稿 - 写下你的想法，不要担心风格
- 结构 - 以清晰的层级结构组织你的内容
- 编辑 - 应用 Strunk & White 原则：
- 删除不必要的词语
- 使用主动语态
- 具体且实在
- 检查段落的统一性和连贯性
- 应用编辑测试 - 使用四个问题的测试、洛城故事测试和模糊的眼睛测试
- 大声朗读 - 测试自然的流畅性和节奏
- 定稿 - 检查格式、链接和参考文献
语法和标点符号指南
逗号
- 使用牛津逗号（在三个或更多项目的列表中的最后一个逗号）。
- 使用逗号分隔由并列连词（and, but, or, nor, for, so, yet）连接的独立子句。
- 在引导性从句和短语后使用逗号。
- 使用逗号来分隔非必要信息。
破折号和连字符
- 使用长破折号 (—) 表示思想的突然中断，并作为逗号或括号的更强替代方案。我们的长破折号周围没有空格。[1]
- 使用短破折号 (–) 表示范围（2-3 周）。
- 使用连字符 (-) 来构成复合形容词（AI-powered solution）。
大小写
- 标题 (H1/H2)：使用标题大小写（Title Case）——将主要单词的首字母大写。
- 副标题（H3 及以下）：使用句子大小写（sentence case），除非设计系统另有规定。
- 将专有名词（包括品牌术语）的首字母大写。
- 不要将通用术语的首字母大写，除非它们位于句子的开头。
数字
- 拼写出零到九的数字；对于 10 及以上的数字，使用阿拉伯数字。
- 对于所有带有单位的测量值，使用阿拉伯数字。
- 对于日期、时间、百分比和货币，使用阿拉伯数字。
- 在 1,000 及以上的数字中使用逗号。
- 使用 "1800s/1900s/2000s" 而不是 "19th/20th/21st century"。使用世纪数字会让很多人感到困惑，因为 19 世纪实际上指的是 1800 年代。为了清楚起见，始终使用具体的年份。
- 在标题和幻灯片标题中使用 "$1 T / $500 B / $50 M" 缩写；在正文中，拼写出数字一次并添加上下文（例如，“≈17% of 2016 GDP”）。
缩写：i.e. 与 e.g.
- 使用 i.e.（id est，“换句话说”）来澄清或重述前一个子句。
- 使用 e.g.（exempli gratia，“例如”）来引入说明性示例。
- 助记符：i 代表 in other words；e 代表 example。
- 始终在缩写后放置一个逗号（i.e., … / e.g., …）。
示例
I plan to visit many European countries, e.g., Portugal, Spain, and France. I plan to visit many European countries, i.e., I have a very full itinerary.
"data" 的用法
将 data 视为一个不可数名词——写 "data is" 而不是 "data are"，除非严格的学术风格指南要求使用复数。在面向客户的写作中，"Data are" 听起来常常是不必要的迂腐。
观点
当代表 Alephic 的集体立场时，使用 we（网站副本、文档和其他未署名的内容）。对于署名的文章或个人轶事，使用 I。无论你选择哪种观点，都要保持相同的果敢、务实和简单的声音。
标题和引语
- 撰写一个10 个字或更少的 H1 标题，说明关键的张力或惊喜。
- 紧随其后的是一个单句描述/导语，解释为什么它很重要。
- 对于幻灯片或英雄副本，保持每行少于 12 个字，并倾向于平行结构。
证据和引用
- 链接到任何统计数据、引语或外部概念的第一个可信来源。
- 每当你提出一个数字时，添加上下文（百分比、时间范围、基准）。
- 使用内联超链接；只有当多个引用会扰乱流程时才使用脚注。
- 如果链接文本本身不能解释清楚，则包含来源名称。
术语和流行语过滤器
避免空洞的流行语。如果一个技术术语是必不可少的，给出一个简短的定义。我们立即删除的词：协同作用（synergy），颠覆（disruption），数字化转型（digital transformation），利用（leverage，作为动词），范式转变（paradigm shift）。
文档风格
- 将读者称为 你；使用祈使动词（"点击 保存"）。
- 以编号顺序呈现步骤，每步一个动作。
- 为每个主要动作提供屏幕截图、GIF 或代码示例。
- 跳过隐喻或故事讲述——文档是用来做的，而不是用来说服的。
幻灯片风格
- 标题 可以是标题大小写（Title-Case）或全部大写（ALL CAPS）以匹配设计。
- 每张幻灯片一个清晰的想法，由 ≤12 个字的微型文案支持。
- 除非幻灯片数据密集型，否则只包含一个视觉元素。
案例研究模板
部分| 目的 ---|--- 挑战| 客户在一句话中遇到的障碍。 Alephic 解决方案| 我们构建或做了什么，在 2-3 句话中。 影响| 量化的结果加上简短的、署名的客户引语。
视觉标准
- 长篇文章：目标是每 ~600 字一个视觉元素。
- 幻灯片：每张幻灯片一个图形，除非内容密集。
- 用什么和为什么来标注视觉元素。
数字缩写
在标题或幻灯片标题中使用 $1 T, $500 B, $50 M。在正文中，拼写出数字一次并添加上下文。
最后的说明
记住，在 Alephic 写作的重点不是听起来聪明——而是被理解。房间里最清晰的声音通常是最强大的。
写作具有极强的可扩展性。它可以被无限数量的人在任何时间阅读。在我们公司内部，写作用于交流、交谈、思考和存档我们的集体智慧。
我们的文档和我们的写作就是我们的历史。这个历史越精确、越最新、越详细——以及越多的人为它讲述的“故事”做出贡献——我们就越有可能识别出哪些不起作用，以及复制哪些有效。
变更日志
- 2025 年 5 月 2 日：在“数字”部分添加了关于使用 "1800s/1900s/2000s" 而不是 "19th/20th/21st century" 以提高清晰度的规则。
- 2025 年 4 月 30 日：写作指南的初始草案。
脚注
[1] 而且，该死的 AI，我们将继续使用长破折号！ About Company Writing Events SaaS Policies Contact