القائمة
模仿作者的技术博客写作风格，生成中文技术系列文章。当用户要求写博客、写文章、写技术教程时使用此技能。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | writing-style |
| description | 模仿作者的技术博客写作风格，生成中文技术系列文章。当用户要求写博客、写文章、写技术教程时使用此技能。 |
| user-invocable | true |
| argument-hint | [主题] [篇目类型:入门/功能/架构/源码] [系列第几篇] [上一篇标题(可选)] |
本文档总结了作者在技术博客系列文章中的可复用写作风格，供大模型模仿使用。
请严格按照以下风格规范生成文章。用户会通过 $ARGUMENTS 传入主题和参数。
每个技术主题通常编写 8~20 篇系列文章，按以下顺序组织：
每个系列的文章统一存放在一个以项目命名的系列目录下，目录名采用项目 GitHub 仓库的 owner__repo 形式（owner 和 repo 之间用双下划线 __ 连接）。系列目录下，每篇文章是一个以数字序号开头的子目录：
<owner>__<repo>/
├── 01-{主题}-{子主题}/
│ ├── README.md # 文章正文
│ └── images/ # 文章截图目录
│ ├── ragflow-login.png
│ └── ragflow-dashboard.png
├── 02-{主题}-{子主题}/
│ ├── README.md
│ └── images/
├── 03-{主题}-{子主题}/
│ └── ...
└── ...
例如：
infiniflow__ragflow/
├── 01-ragflow-quickstart/
├── 02-ragflow-system-architecture/
└── ...
NousResearch__hermes-agent/
├── 01-hermes-agent-introduction/
├── 02-hermes-agent-quickstart/
└── ...
关键规则：
owner__repo 命名，例如 obra__superpowers、NousResearch__hermes-agent、sansan0__TrendRadar。如果 owner 或 repo 名本身含斜杠或其它特殊字符，统一用 __ 替换NN-{主题}-{子主题}，其中 NN 是两位数字序号（01、02……不足两位补零），按系列阅读顺序从 01 依次递增README.md 中images/ 目录用于存放截图例如，写一个关于 RAGFlow 的系列，首篇快速入门应创建：
infiniflow__ragflow/01-ragflow-quickstart/README.md（文章正文）infiniflow__ragflow/01-ragflow-quickstart/images/（截图目录）每篇文章的篇幅适中，通常 200~500 行 Markdown。如果某个主题内容较多，会拆分为多篇，序号顺延即可（如 07-xxx-source-1、08-xxx-source-2），不需要再在标题或目录里另加 -2、-3 后缀来区分。
序号规则：
01，第 N 篇用零补齐的两位数字 NN，按系列阅读顺序依次递增03，也不能从 03 跳到 0501 编到 NN 即可，不用预占日期，也不用担心是串行还是并行产出。每篇天然落在各自的序号目录下，不会出现"挤在同一天"的问题正文里"昨天我们学习了……""我们明天继续"这类衔接语仍可照常使用（见 3.2、3.4 节），它表达的是阅读/发布节奏，与目录是否带日期无关。
标题格式通常为以下几种模式：
{工具名} 快速入门{工具名} 介绍：{一句话描述}学习 {工具名} 的{主题}（最常用的格式）再学 {工具名} 的{主题} / 深入 {工具名} 的{主题}示例：
# RAGFlow 快速入门# Claude Code 介绍：一款运行在终端里的智能编程助手# 学习 Dify 的代码结构# 学习 LiteLLM 的路由和回退策略# 再学 RAGFlow 的问答流程系列首篇的任务是让读者快速理解 项目要解决什么问题、为什么值得继续读下去。下面三种开头模式都可以使用，按使用频率从高到低排列。无论用哪种模式，都必须避开末尾"教科书式开头红线"里描述的写法。
模式 A：具体问题陈述 + 项目引入（最常用，作者最自然的开头方式）
直接点出该项目针对的真实开发痛点，把读者带入"我也遇到过这个问题"的语境，再自然引出项目本身。要点是具体——能点名的产品名、技术名、API 差异、版本号、规范名等可验证事实越多越好，不要停留在抽象趋势话术上。
正面示例（来自 LiteLLM 入门篇）：
在 AI 应用的开发过程中，开发者们往往面临一个共同的难题：如何高效地集成多家
LLM 服务商的接口？不同的服务商提供的 API 设计各不相同，OpenAI 有自己的风格，
Anthropic 有另一套标准，Azure OpenAI、Google Vertex AI 又有各自的特色……
这段为什么合格：开篇就点出了 OpenAI / Anthropic / Azure / Vertex 四个具体产品，描述的是每位 LLM 应用开发者都真实碰到过的 API 不一致问题，没有空泛地讲"AI 时代来临"。
模式：{具体痛点描述（带产品名/技术名）} → {自然引出项目} → {核心特性列表} → {本文目标}
模式 B：近期热点事件 / 社区热议切入（锦上添花，能搜到就用）
如果在动笔前能搜到 1~3 个月内该项目的鲜活动态，把它作为开头切入点会让文章更有时效性和"圈内感"。这不是必须项，但有的话非常加分。优先级从高到低：
涉及贬损性的热点（安全漏洞、社区治理争议、维护者翻车、代码质量投诉等）虽然也是"近期热点"，但不适合用在介绍篇开头，详见下文"热点选择必须与篇目定位匹配"。
正面示例：
2025 年 3 月 6 号，中国 AI 创业公司 Monica 发布 Manus，号称 "全球首款通用 AI 代理"
……根据后来网友的爆料，其核心功能使用的是开源的 Browser Use 项目。
最近两个月，国内开发者圈子里掀起了一阵"养龙虾"热 —— 字节、阿里、美团等大厂的
技术团队纷纷开始基于 OpenClaw 搭建自己的内部 AI 助手。OpenClaw 在国内被亲切地称为
"小龙虾"，这个名字来自它的吉祥物 Molty —— 一只太空龙虾。
上周 Hacker News 上有一篇帖子火了：一位独立开发者用 OpenClaw 把自己的 WhatsApp、
Telegram、Slack 全部打通，实现了"一个 AI 管所有聊天"。评论区里不少人感叹：
这不就是我一直想要的东西吗？
模式：{近期热点/社区现象} → {自然引出项目} → {核心特性列表} → {本文目标}
模式 C：版本 / 时间节点切入（特定场景）
如果项目有明确的版本节奏或行业级时间点（语言新版发布、LTS 更新、规范升级、官方里程碑等），用这个时间节点切入很自然。
正面示例（来自《重温 Java 21 学习笔记》）：
2025 年 9 月 16 日，Oracle 正式发布了 Java 25 版本，这是 Java 时隔两年发布的
又一个 LTS 版本……
模式：{时间节点 + 行业事件} → {唤起读者对相关技术的记忆} → {本文目标}
模式选择建议
教科书式开头红线（三种模式的共同底线）
无论选用哪种模式，开头绝对不能写成下面这种纯概念话术——它的特征是通篇没有具体的产品名、版本号、日期、数字或 API 名，全是"概念升温""时代来临""玩具变工具"之类的抽象修辞：
2025 年以来，AI Agent 的概念在技术圈持续升温。从最早的聊天机器人，到如今能自主规划、
使用工具、甚至操控浏览器的智能体，个人 AI 助手正从"有趣的玩具"变成"不可或缺的
生产力工具"。然而，大多数 AI 助手要么运行在云端……
判定方法：写完开头后，把所有描述时代/趋势/概念的修饰语去掉，看剩下的内容里具体可验证的事实（产品名、版本号、日期、数字、API 名、公司名）有几个。如果剩不下几个，就要重写。
热点选择必须与篇目定位匹配
找到一个真实的近期热点只是第一步，还要判断这个热点适不适合放在介绍篇开头。系列首篇的任务是让读者对项目产生好感和好奇，不是让读者警惕或避开它。下笔前先问自己一句：读者读完开头 200 字，第一印象会是"这项目值得看"还是"这项目有问题"？如果是后者，换开头。
贬损性热点不是不能用，而是要留到系列中专门讨论该话题的那一篇。举例：如果系列后续规划里有"安全供应链"专题篇，那安全 issue 应该留到那一篇开头用，不要在介绍篇就展开；把素材用在对口的位置，既不会污染介绍篇的第一印象，也能让专题篇保留独家感。
介绍篇的热点取"全局视角"而非"单点视角"：前者（规模、速度、赛道坐标、现象级采用）描述的是项目整体状况，天然配得上"介绍"二字；后者（某个漏洞、某条 issue、某次社区争吵）描述的是某个切面，更适合挂在对应的专题篇上。
禁止预告系列总篇数：不要写"在接下来的 12 篇文章中"、"本系列一共 10 篇"这类预告总数的说法。原因：系列文章是边写边规划的，篇数随时可能调整，写死数字既不自然也容易过时。正确做法是用模糊的表述引出后续内容，比如"在接下来的文章中"、"在后续的系列文章中"。
以回顾前文内容作为衔接，然后引出今天的主题：
在前面的系列文章中，我们从实用的角度学习了 Dify 的部署方式、应用创建和各种应用类型的使用方法。今天，我们将深入 Dify 的源码……昨天，我们对 RAGFlow 的问答流程进行了全面的学习……不过，问答过程中还有不少有趣的点可以展开学习，我们今天就继续深入这些细节。在上一篇中，我们学习了 Claude Code 的 Bash、LS、Glob 和 Grep 四个工具……我们今天继续看下其他的工具。关于 Mem0 的配置选项，还差最后一个 graph_store 没有学习……今天我们就来看看 Mem0 是如何结合图数据库来做记忆管理的。经过几天的实战和学习，我们已经全面体验了 Coze Studio 从智能体、插件、工作流到知识库的各项核心功能。今天，我们开始研究下它的源码……模式：{前文回顾} → {引出今天主题} → {简述本文内容}
最后一节标题为 ## 小结（偶尔用 ## 未完待续），内容包括两部分：
第一部分：总结本文内容
用 1~2 段话或编号列表回顾今天学到的要点：
通过对 Dify 代码结构的分析，我们可以看到：
1. **前后端分离架构**：后端使用 Python Flask 提供 API 服务，前端使用 Next.js 构建用户界面
2. **分层设计思想**：控制器、服务、仓储、模型层职责清晰，代码组织良好
3. **灵活的启动模式**：支持数据库迁移、API 服务和 Celery 任务三种运行模式
4. **模块化扩展系统**：通过扩展机制组织各种功能，支持按需加载和禁用
第二部分：引出下一篇
用自然的语气预告明天的内容，制造连续阅读的期待感：
不过细心的读者可能会发现一个问题：……答案就在扩展系统中的 ext_blueprints 模块。……我们明天就来看看这部分内容。Claude Code 的工具箱里还有不少其他好玩的工具，我们明天继续。在后续的文章中，我们将结合源码深入其核心，探索更多高级功能……不过百闻不如一见，百见不如一试，……我们明天就来看看 Mem0 的代码。关于知识提取阶段还有另外两个工作流，我们明天继续。每篇文章在 ## 小结 之后都必须追加一节 ## 参考，把正文中引用过的所有外部网址按出现顺序汇总成列表。这一节是文章的"出处声明"，让读者能快速跳转到原始资料，也能避免读者怀疑内容是凭空编造。
只要在写作过程中（包括 4.0 节要求的热点搜索阶段）打开过、或在正文中以任何形式引用过的 URL，都要收录：
* ，每行一个链接[简短中文描述](URL)，纯 URL 不易判断内容示例：
## 参考
* [OpenClaw 官网](https://openclaw.io/)
* [OpenClaw GitHub 仓库](https://github.com/openclaw/openclaw)
* [OpenClaw v2.0 发布说明](https://openclaw.io/blog/v2-release)
* [技术报告：OpenClaw 架构白皮书](https://openclaw.io/papers/architecture.pdf)
* [Hacker News：用 OpenClaw 打通 WhatsApp/Telegram/Slack](https://news.ycombinator.com/item?id=12345678)
* [V2EX：小龙虾在国内的使用经验](https://www.v2ex.com/t/987654)
## 参考 节追加一条，不要等全文写完再回头补——回头补几乎一定会漏## 参考 节是对它们的汇总；不要因为加了参考节就把正文的行内链接删掉## 参考 节；但只要正文里出现了哪怕一个外部链接，这一节就必须存在让文章"活起来"、与干巴巴的官方文档拉开差距的核心手段，是把鲜活的项目动态自然地融入文章。搜索是手段，不是义务——能搜到合适素材就用 3.2 节的"模式 B"开篇；搜不到就用"模式 A"或"模式 C"，开头里仍然要追求具体而非空洞。
写每个系列的第一篇之前，建议花 5~10 分钟搜一下项目的近期信息（搜不到也不强求）：
搜到的素材有多种用法，不一定全部塞进开头：
> OpenClaw 在国内被亲切地叫做"小龙虾"，连它的 Discord 频道里都有一个 #lobster-memes 表情包专区。使用 $ 前缀表示 shell 命令，命令输出不加前缀：
$ docker --version
Docker version 24.0.2, build cb74dfc
$ docker compose version
Docker Compose version 2.38.1
如果给读者一句英文提示词让他照着用（比如丢给 AI 编程助手的指令），在代码块里紧跟一行 # 注释给出中文翻译，方便读者理解意图：
Make a 45-second animated explainer about why the sky is blue
# 做一个 45 秒的动画解说视频，讲讲天空为什么是蓝色
同一篇里多条英文提示词要保持同样的「英文 + # 中文」格式。
引用代码时只写文件名，不写行号。原因有二：一是开源代码变动很快，行号很快就会过时；二是带行号显得机械生硬，不够自然。正确示例：其实现逻辑位于 app.py 文件：，错误示例：其实现逻辑位于 app.py 的第 42 行：
展示关键代码片段，然后用文字逐步解读：
def create_app() -> DifyApp:
# 1. 创建 Flask 应用并加载配置
dify_app = DifyApp(__name__)
dify_app.config.from_mapping(dify_config.model_dump())
# 2. 初始化扩展系统
initialize_extensions(app)
return app
代码之后紧跟解读：
应用创建流程分为两个关键步骤：
1. **创建 Flask 应用**：初始化 DifyApp 实例，并加载配置
2. **初始化扩展系统**：按顺序加载所有功能扩展，这里是程序启动的关键
用缩进树形结构展示项目目录，并在关键目录后加注释：
api/
├── app.py # 应用入口文件
├── controllers/ # 控制器层 (路由处理)
├── services/ # 服务层 (业务逻辑)
├── models/ # 模型层 (数据模型)
└── core/ # 核心功能模块
YAML、JSON 等配置文件中用注释说明每个字段的含义：
model_list:
- model_name: gpt-4o
litellm_params:
model: azure/gpt-4o
api_base: https://my-endpoint-us.openai.azure.com/
api_key: os.environ/AZURE_API_KEY
weight: 9 # 90% 的概率被选中
作者写作讲究图文并茂，图片是文章不可或缺的组成部分。文章中的图片分为三类，生成时必须根据场景选择正确的类型。
第一类：Mermaid 图（流程图、架构图、时序图等）
适用场景：系统架构图、程序流程图、数据流图、调用链时序图、状态机、模块关系图、类图等可以用结构化语法描述的图。
格式：直接在 Markdown 中使用 Mermaid 代码块，不需要图片文件。
整体架构如下图所示：
```mermaid
graph TB
A[用户请求] --> B[Gateway]
B --> C[路由模块]
C --> D[AI 模型]
C --> E[插件系统]
D --> F[响应]
E --> F
```
Mermaid 图的要求：
graph TB/LR（流程图）、sequenceDiagram（时序图）、classDiagram（类图）、stateDiagram-v2（状态图）、flowchart（流程图）等第二类：AI 生成图（概念示意图、场景图、封面图等）
适用场景：产品概念示意图、技术场景配图、文章封面/题图、比喻性插图等无法用 Mermaid 结构化描述，但也不是实际截图的图。
格式：使用 Markdown 图片语法，在 [] 中写入详细的图片生成提示词（英文），作者后续会根据提示词调用图片生成模型生成对应的图。
提示词的要求：
digital art style、flat illustration、technical diagram style、isometric illustration、minimal line art 等第三类：截图占位符（UI 截图、运行结果、实际界面等）
适用场景：产品 UI 界面、Web 控制台、终端运行结果（大段日志/彩色输出）、配置界面、实际操作步骤的截图等必须从真实软件中截取的图。
格式：使用 Markdown 图片语法，[] 中留空（不写 alt text），作者后续会手动截图补充。
| 场景 | 图片类型 | 格式 |
|---|---|---|
| 系统架构、模块关系 | 第一类 Mermaid | ```mermaid ``` |
| 程序流程、调用链 | 第一类 Mermaid | ```mermaid ``` |
| 时序图、状态机 | 第一类 Mermaid | ```mermaid ``` |
| 类图、ER 图 | 第一类 Mermaid | ```mermaid ``` |
| 概念示意图、场景图 | 第二类 AI 生成 |  |
| 文章封面、题图 | 第二类 AI 生成 |  |
| 比喻性插图 | 第二类 AI 生成 |  |
| 产品官网/GitHub 首页 | 第三类截图 |  |
| UI 操作步骤 | 第三类截图 |  |
| Web 控制台/Dashboard | 第三类截图 |  |
| 终端运行结果（大段） | 第三类截图 |  |
| 配置界面 | 第三类截图 |  |
openclaw-gateway-architecture.png、quickstart-first-chat.png登录成功后，看到如下界面： / 运行效果如下： / 整体架构如下图所示：必须配图的场景（出现一次就配一张）
一般不配图的场景
用 > 引用块表示补充说明、注意事项、小贴士：
> 注意这里使用了 Neo4j 的最新版本 neo4j:2025.04，有些老版本可能会由于不支持……而报错。> 吐槽下 RAGFlow 的登录页面，这背景图选的，文字都看不清。> 值得注意的是，针对速率限制错误，LiteLLM 使用指数退避（Exponential Backoffs）重试策略……> 除了 flask db upgrade 命令，Flask-Migrate 还支持很多其他的 flask db 子命令……偶尔也用于吐槽或带点幽默感的个人评价。
用表格做分类整理或对比：
| 分类 | 分类描述 | 示例工具 |
| ---- | ------ | ------ |
| **命令执行** | 允许在 Shell 会话中执行 Bash 命令 | `Bash` |
| **文件查找** | 用于快速查找并匹配文件 | `LS`、`Glob` 和 `Grep` |
**领域驱动设计（Domain-Driven Design，简称 DDD）**真正做到 **Quality in, quality out**`Bash`、`rg`* **深度文档理解**：不仅仅是提取文本，RAGFlow 能够深入理解各类复杂文档的布局和结构……
* **智能文本切片**：提供基于模板的文本切片方法，不仅智能，而且整个过程清晰可控……
[RAGFlow](https://ragflow.io/)感兴趣的话，可以看下他们的技术报告：
* https://browser-use.com/posts/sota-technical-report
[Pydantic](https://pydantic.dev/)、[Celery](https://github.com/celery/celery)## 参考 节，格式与收录范围见 3.5 节两类词在第一次出现时都要就地解释，否则读者会卡壳：
## 参考（3.5 节）。引入方式通常是引用块：
> uv 是一个极速的 Python 包和项目管理工具……
> CLIP 是 OpenAI 在 2021 年开源的图文模型，它能把图片和文字映射到同一个向量空间……
判定：通读全文，凡是一个英文词/缩写第一次出现却没有任何解释，就补一句。宁可多解释，也不要默认读者都懂。最容易漏的是 props、explainer、motion graphics、烧录、ffprobe 这种「写代码 / 做视频的人觉得理所当然、但跨领域读者未必懂」的词。
解释必须技术正确：给术语打的比方要经得起推敲，确认这个例子体现的是该技术独有的能力，而不是某个更基础的技术也能做的事。举个容易犯的错：解释跨模态检索模型（如 CLIP）时，举例「让『一段海浪的镜头』和『ocean waves at dusk』落在相近位置」——但这两个都是文字，是普通文本 embedding 就能做的，没体现「图片↔文字映射到同一空间」这个独有能力。正确的例子应该一端是图、一端是文字。
---）（除非是文件级分隔）、无花哨排版—— 和双引号 ""：详见 5.0 节的红线条款，这是最容易跑偏的一处**领域驱动设计**），不要整句加粗当 slogan作者真实的文章行文是短句为主、技术性过渡、几乎不修辞。生成时最容易走偏的地方不是内容，而是行文节奏——堆破折号、堆双引号、堆反问、堆"编辑腔评语"，一段下来就完全不像作者本人。下面这些是硬红线。
——：只用一种场景作者的真实用法只有一种：同位语或具名引出，形如 一个 X —— Y 或 一款 ... 的 Y —— Z。例如：
一款基于终端的 AI 编程助手 —— Claude Code本文的主角 —— Dify 代码沙箱Presidio 是微软开源的数据保护工具包，名称源自拉丁语 praesidium，意为 保护禁止的破折号用法（这是生成文章最严重的毛病）：
—— 做修辞性停顿/强调："它能走到这一步，背后的原因不是营销——这正是..."—— 衔接一个评论小尾巴："换句话说，它是一份可落地的框架——任何一层单独看都不完整"———— 出现次数建议控制在 3 次以内，绝大多数段落里应该一个都没有如果你写完一段发现有多个 ——，几乎肯定要改成句号断开的短句。
""：只引真实引文，不做强调作者几乎从不用中文双引号做"吐槽式"或"概念强调"。强调手段的优先级是：
**关键概念**（最常用）`flag`、`file.py`（专有名词、配置项、文件名）""：只在你要逐字引用书名、引文、术语原文时才用禁止的双引号用法：
"把学英语当成项目来跑"、"Markdown 指南长读型"、"万物皆 SaaS"、"文档化"、"离谱""答疑一个具体的人"、"目标态预览"、"SUMMARY 比实际内容少""为某个具体的人写"、"小龙虾" 式别名是例外（真实社区昵称，且第一次出现时可以加引号引出，之后直接使用）简单判据：如果一个短语不是从书里、官方文档、公开发言里逐字抄下来的，就不要给它加双引号——要么用粗体，要么去掉修饰直接说。
作者会用设问引导下一节内容（如"那么 Dify 是如何处理 HTTP 请求路由的呢？"），但从不在一段话里连续打三四个问号。
禁止：你到底为什么要学？你是不是又打算靠"用力过猛"把自己再逼一次？、它从哪里来？是什么？凭什么值得我们花一个系列去读？
正解：直接陈述。这篇文章先不急着拆章节，而是把项目本身讲清楚：它从哪里来、是什么、为什么值得花一个系列的时间去读。
作者的自然句长一般在 15~35 字一句。超过 50 字的复合长句属于例外，不该成为常态。
反面节奏（生成文章的典型病症，禁止）：
一份纯 Markdown 的指南能走到这一步，背后的原因不是营销，而是它的内容本身——这正是我们想用一个完整系列把它拆开聊清楚的动机。
问题：一句话里塞进 3 个子命题 + 1 个破折号修辞尾巴。
改写（作者口吻）：
一份纯 Markdown 的指南能做到这种影响力，靠的不是营销，而是内容本身。这也是我们打算用一个系列把它拆开聊的原因。
作者是技术博客语气，不是专栏随笔语气。下面这类句子一律禁止出现：
把这件事再说得直白一点 / 换句话说，它是...一句话定义 / 更有意思的是 / 值得一提的是 / 另外顺带一提（当做段落/小节开头时）最后拼的就是你愿不愿意持续投入 / 堆是堆不出来的这份指南最不文档化、但也最有力量的地方在 2026 年万物皆 SaaS 的语境下，反而显得有点稀缺它已经从一份 README 变成了一种文化现象）下面几类是生成文章时最容易冒出来的，单独列出来：
老老实实标了成本、数字低得出乎意料、这个区别很要命、是里面最重的依赖、装起来不轻、相当吃力。判定：把形容词/副词删掉句子照样成立，就删掉。比如「每条都老老实实标了成本，数字低得出乎意料」→「每条都标了成本」，后面的数字自己会说话有一句话说得很直白、专门点了一句、一针见血地指出、说得很到位。引文够不够直白让读者自己看，引出时一律用中性说法：……里是这样描述的： / 原文如下： / 里有这么一句：X 有一个我很喜欢的设计：……、我个人很欣赏的一点是……。直接说这个设计是什么，不要先表一句态这里有一点要注意、值得留意的是、这里其实有个细节。删掉直接讲事实，或只用 不过 / 其实 这种一个词的转折一个诚实的结论是……、真正最轻的那条路恰恰是……。把价值判断删掉，事实留下这些句子的共同特征：给事实加价值判断、给现象贴 slogan。作者的风格是摆事实、给数据、让读者自己得出结论。写完一段，把所有"编辑腔"句子删掉，段落通常反而更干净。
以下反面示例均来自 byoungd__English-level-up-tips/01-english-level-up-tips-introduction/README.md，改写版是作者真实口吻应有的样子：
反面：
最近两三年，中文技术圈悄悄刮起了一股"把学英语当成项目来跑"的风。开发者们不再只是在 Anki 里囤卡包、每天打一下 Duolingo 的连击，而是直接跑去 GitHub 上找那种"Markdown 指南长读型"的仓库当教材——byoungd/English-level-up-tips 就是这股风里被讨论得最多的一份。
问题：2 个态度引号、1 个修辞破折号、过度口语化"囤卡包""打连击"、把一个项目包装成"一股风"的文化评论。
改写（作者口吻）：
最近两三年，越来越多开发者开始在 GitHub 上找 Markdown 形式的英语学习指南来当教材，byoungd/English-level-up-tips 就是其中关注度最高的一个。截至 2026-04-24，这个仓库 star 数已经达到 43,194，fork 数是 4,569。
反面：
更有意思的是，这份指南在 2026 年并没有"封笔变成静态文档"，它还在持续更新。就在一个多月前的 2026-03-20，作者把整章的 AI 内容 docs/threads/part-1/7-ai.md 直接推翻重写，换成了 "2026 Gemini 版"——把 Guided Learning + Gems + Live + Canvas 串成一条英语学习的完整链路。
问题：更有意思的是编辑腔、"封笔变成静态文档"态度引号、"2026 Gemini 版"不必要的引号、修辞破折号。
改写：
这份指南在 2026 年仍在持续更新。一个多月前的 2026-03-20，作者对 AI 章节
docs/threads/part-1/7-ai.md做了一次重写，把内容完全切换到 Gemini 的 Guided Learning、Gems、Live 和 Canvas 上。
反面：
英语这种东西，靠工具栏堆是堆不出来的，最后拼的就是你愿不愿意持续投入。
问题：纯编辑化鸡汤金句，技术博客不应出现。
改写：直接删掉，让上一段的事实自己说话。
今天我们就来看看……、我们来逐一分析下我使用 Wireshark 对 Claude Code 的请求抓包分析、我也算是 Coze 的老用户了、我试了下如果你只是想对 Claude Code 尝尝鲜瞅了一眼、瞬间就不香了、这不得好好研究下它的代码嘛、再也不用担心 API 费用把钱包掏空了慢慢扒（→ 慢慢展开/细看）、组件吃下数据（→ 接收）、把 X 死死钉在 Y（→ 锁定为）、趁热瞄一眼源码（→ 顺便看一眼）、请求打到接口（→ 调用接口）、表格表头 动起来靠（→ 运动来源）。判定：一个口语动词如果牺牲了准确性、或读着像硬凑的「网感」，就换成平实的说法。扒一扒「钉死」「吃下」这类一律避免今天，我们就来……下面我们通过一个简单的示例来体验下……接下来，我们也亲自实践验证一下让我们从最简单的场景开始首先，让我们从……开始首先…… → 然后…… → 接着…… → 最后……配置确认无误后，使用……启动成功后如下：创建成功后，就可以……可以看到……（最高频的过渡句，几乎每篇文章出现多次，用于代码/截图之后引出观察）从上图可以看到，……从这个目录结构可以看出，……很显然……也就是说，……简单来说，……其实……（用于揭示本质或纠正常见误解）不过，……当然，……此外，……要注意的是……值得注意的是，……那么这个 xxx 是什么意思呢？那么 Dify 是如何处理 HTTP 请求路由的呢？这个时候如果我问"……"，通过图谱显然是回答不上来的。Dify 的扩展系统是其架构的一大亮点、设计得相当完善、整个过程非常丝滑这次的更新有点差强人意吐槽下 RAGFlow 的登录页面，这背景图选的，文字都看不清纸上得来终觉浅，绝知此事要躬行；讲架构全局俯瞰时用一次会当凌绝顶，一览众山小——引用必须是点睛之笔，读起来自然、贴切整体的逻辑还是比较清晰的、主要脉络还是比较清晰的当时我还以为记忆是保存在内存里的。后来看源码才发现其实不对可以把镜像比喻成一个模板、规划和记忆好比人的大脑……工具使用好比人的五官和手脚回退和重试的区别：重试是针对同一部署的多次尝试……而回退尝试不同的部署……让我们从最简单的场景开始这里的代码做了简化，只保留了主要部分，用 # ... 注释标记省略的代码Eric Evans 在 2004 年出版了《领域驱动设计》一书、最早关于 GraphRAG 的概念实际上可以追溯到去年微软研究院发表的论文X 是 Y 的标准定义格式：Browser Use 是一款基于 Python 的开源 AI 自动化工具、Neo4j 是图数据库领域的老牌选手idea → scene_plan → … → compose），但前文从没讲过它分哪几个阶段；② 引用一个只在某段 JSON / 配置里一闪而过的字段（如某个 xxx_runtime），却没说它是什么、谁来定。正确做法：第一次用到某个流程/字段时，先用半句话交代它是什么（这个字段指定一支视频最终用哪个引擎渲染），或明说「细节后面单开一篇讲，这里只需知道……」，再往下展开。判定：每引用一个 代码字段 / 阶段名 / 专有流程，回看前文——读者在这一行之前是否已经知道它是什么？不知道就先补一句。以下是高频出现的短语，可直接复用：
感兴趣的同学/朋友可以……（引导读者查看可选的延伸资料）下面我们通过一个简单的示例来体验下……（从理论转入实践）其实现逻辑位于 {文件路径} 文件：（引出源码展示）这里有几个点比较有意思，可以展开介绍一下（深入分析前的过渡）我们来逐一分析下（分点详解的过渡）我们今天暂且跳过，后面单开一篇介绍（延迟讨论的标记）这里不再赘述（避免重复已有内容）比如……（高频举例过渡词）**检索增强生成（RAG）**使用 Docker 和 Docker Compose版本在 24.0.0 以上`app.py`、`flask run`； 用于列表项内部的分隔—— 仅用于同位语引出：一款基于终端的 AI 编程助手 —— Claude Code。不得用于句中修辞停顿，单段不得超过 1 次、整篇建议不超过 3 次。详见 5.0.1"" 仅用于真实逐字引文（书名/公开发言/术语原文），不得用作态度引号或概念强调。强调用粗体或行内代码。详见 5.0.2README.md 只是博客文件的固定文件名，不是给读者看的内容。## 参考 里也别单列一条「XXX README」，用「XXX GitHub 仓库」即可images/ 目录images/ 目录下ragflow-login.png、neo4j-browser.png（[] 内写图片生成提示词）（[] 内留空）images/ 目录尚未创建、图片文件尚未存在，也必须在正文中按 4.2 节的规则插入对应类型的占位符。不要以"图片还没准备好"为由省略——占位符本身就是文章的一部分当一个系列进入最后一篇时，结尾风格会有所不同：
至此，我们对 GraphRAG 的探索之旅也告一段落……希望这个系列的文章能帮助你全面理解……以下是一篇系列后续文章的典型模板：
# 学习 {工具名} 的{主题}
{1~2 段回顾前文并引出今天主题的开头}
## {第一个主要章节}
{概念介绍或背景说明}
{代码示例或截图}
{对代码/截图的解读}
### {子章节}
{进一步的细节展开}
## {第二个主要章节}
{更深入的内容}
> {补充说明或注意事项}
## {第三个主要章节（如有）}
{……}
## 小结
{1~2 段或编号列表回顾今天的要点}
{1~2 句预告下一篇的内容，通常以"我们明天继续"结尾}
## 参考
* [{资源简短中文描述}]({URL})
* [{资源简短中文描述}]({URL})
* ……
## 参考节的收录范围、格式和写作流程见 3.5 节。只要正文中出现过哪怕一个外部链接，就必须有这一节。
写完一篇之后，在交稿前必须按下面这份清单逐项自查。任何一项不通过都要原地改，不得跳过。
—— 全文 grep 一遍：每次出现都要能套进 X —— Y 的同位语模板；句中修辞停顿的一律改成句号或逗号。整篇 —— 出现次数 ≤ 3"" 全文 grep 一遍：每一对都要对应一段真实引文（书名、公开发言、术语原文）或公认的社区昵称。态度引号、概念强调引号一律删除，改为粗体或直接描述？。如果出现连续两个问号在同一段，改成陈述句更有意思的是 / 值得一提的是 / 值得留意的是 / 这里有一点要注意 / 另外顺带一提 / 把这件事说得直白一点 / 换句话说 / 一句话定义老老实实 / 出乎意料 / 很要命 / 最重的 / 装起来不轻 / 有一个我很喜欢的设计 / 一个诚实的结论是说得很直白 / 专门点了一句 / 一针见血最后拼的就是 / 堆是堆不出来的 / 已经从 X 变成了 Y 式金句**...。**，把整句话加粗的句子改回普通陈述扒 / 钉死 / 吃下 / 瞄一眼 / 打到，凡是牺牲准确性或硬凑网感的，换成平实说法（见 5.1）git log 第一个 commit 或 GitHub API 的 created_at，别把媒体报道日 / 文章发布日当成开源日stargazers_count），别用搜索摘要里的数字（搜索摘要常不准，甚至虚高一倍）props、explainer、motion graphics、烧录、ffprobe 这类最容易漏，见 4.8）代码字段 / 阶段名 / 专有流程，读者在该行之前是否已经知道它是什么；限定词（「免费的」「这条路径的」）的归属范围是否准确（见 5.4）## 参考 是否登记了所有正文外链（3.5 节）owner__repo/NN-slug 格式、序号从 01 起连续递增且无跳号或复用（2.2 / 2.3 节）改稿一致性：删一节、移一节后，回头检查 ## 小结 的对应要点、以及别处对它的交叉引用（「上面那节」「后面会讲」）是否还成立，别留悬空指代。
一句话判据：读者读完这段，脑子里留下的应该是新的事实 / 新的代码 / 新的数据，而不是作者又评价了一番。如果删掉某句话段落照样成立，基本就该删。