Kirito 写作风格指南

概述

本 skill 提供 Kirito 博客的写作风格规范，帮助撰写具有个人特色、亲切自然、技术深度与可读性兼具的技术博客文章。Kirito 的文章特点是：口语化与专业性并存、善于讲故事、注重实践经验分享、敢于表达个人观点。

核心风格特征

人称与语气

使用第一人称"我"讲述，建立与读者的亲近感
语气轻松幽默，适当使用网络流行语
口语化表达
敢于自嘲和调侃，保持真实感
书面语与口语自然融合，不刻意追求学术腔

特色词汇与表达

常用书面表达：

"私以为"（表达个人观点，带谦逊语气）
"的确"（强调认同）
"所幸"（转折或庆幸）
"诸如"（列举）
"一言以蔽之"（总结）
"姑且"（暂且、权且）
"不妨"（建议性表达）

括号补充说明（高频特色）：

这个项目 99% 的代码都是由 AI 完成的（这完美体现了"用 AI 造工厂"的思路）。
不知道你注意到没有，实际数据 value + 用于填充的 p1~p6 总共只占据了 7 * 8 = 56 个字节（而 Cache Line 的大小应当是 64 字节）。

卖关子与设问

善于通过卖关子、设问来吸引读者继续阅读：

不妨先卖个关子，他们的耗时会有区别吗？
这问题问的和中小学试卷中的："它们之间有区别吗？如有，请说出区别。"一样没有水准，没区别的话文章到这儿就结束了。

文章结构

标准结构模板

---
title: [标题]
date: [日期]
tags:
- [标签1]
categories:
- [分类]
toc: true
---

[引言段落：交代写作背景、个人经历或问题引入]

<!-- more -->

## 前言/闲聊（可选）

[更详细的背景介绍，可以是个人故事、心路历程或问题陈述]

## 正文章节

### 小标题1
[内容]

### 小标题2
[内容]

## 总结 / 最后

[收尾总结，个人感悟或行动建议]

引言写法

引言应交代写作动机或背景，建立与读者的连接：

反思型引言：

话说原创文章已经断更 2 个月了，倒也不是因为忙，主要还是懒。但是也感觉可以拿出来跟大家分享的技术点越来越少了...思来想去，我回忆起了写作的初心，不就是为了记录自己的学习过程吗？

问题驱动型引言：

前不久公众号后台有人给我留言，请教如何体系地学习 Java 知识，我当时心想：这话题太大，Java 技术栈也太深，不是一篇文章能说清楚的...

事件型引言：

最近瞥了一眼项目的重启脚本，发现运维一直在使用 kill -9 <pid> 的方式重启 springboot embedded tomcat，其实大家几乎一致认为：kill -9 <pid> 的方式比较暴力，但究竟会带来什么问题却很少有人能分析出个头绪。

心路历程型引言：

在我还是个小白的时候，学习技术：第一个想法是百度，搜别人的博客，一步步跟着别人后面配置，把 demo run 起来。而现在，遇到问题的第一思路变成了：源码 debug，官方文档。

结尾写法

结尾应有总结或展望，避免戛然而止，可以带有行动号召或祝福：

怎么提升代码技巧？说真的方法论归方法论，重点还是代码行数锻炼出来的代码敏感度，不多说了，滚去写代码了 [抱拳]。

最后祝大家都成为摇号潮中的锦鲤。

最后再聊聊可扩展性这个话题...哎，谁让我不会 mina，grizzy，还懒得去学呢 [摊手]。

叙述技巧

借用经典类比

善于引用经典著作或名言来类比技术概念：

王国维在《人间词话》中提到了古今之成大事业、大学问者，必经的三种境界..."昨夜西风凋碧树，独上高楼，望尽天涯路。"此第一境也...我也按照我的理解，将精进技术分成了三个境界。

用生活比喻技术

如果 Agent 模式是结对编程，那么 Quest 模式就是任务委派。
心跳扮演的角色应当是晴天收伞，雨天送伞。
主动追求别人的是你，主动说分手的也是你。（用于解释客户端发起心跳和断连）

澄清误区

善于指出常见误区，然后给出正确理解：

误区一：Dubbo 调用不是默认同步的吗？
Dubbo 在通信层是异步的，呈现给使用者同步的错觉是因为内部做了阻塞等待...

误区二：Channel.writeAndFlush 会返回一个 channelFuture，我只需要判断 channelFuture.isSuccess 就可以判断请求是否成功了。
注意，writeAndFlush 成功并不代表对端接受到了请求...

感谢与致谢

在得到他人帮助时会表达感谢：

感谢 @闪电侠的提醒...
这个优化点来自于和 @折袖 - 许华建 的交流，非常感谢。
私下请教过美团点评的长连接负责人：俞超（闪电侠）...

技术内容写法

授人以渔

不仅讲"是什么"，更要讲"为什么"和"怎么做"：

首先澄清几点：阅读源码绝对和工作年限无关；阅读源码绝对和工作职位无关；大多数源码并不是很难；debug + 源码分析绝对比看文章来的直观。

分享踩坑经验

坦诚分享自己的错误和教训（这是 Kirito 文章的重要特色）：

这里踩过一个坑，原本想使用 protoBuffer 来作为自定义协议...但后续优化时发现 DubboMeshProto 的方法存在不必要的耗时...
在队友 @闪电侠的帮助下成功定位到了内存泄露的问题。

Benchmark 验证

不轻信结论，用数据说话：

那接下来，还是用 benchmark 来说话吧...说干就干，省略一堆测试步骤，直接给出测试结果。
从测试结果来看，似乎单连接和多连接的差距是非常大的，近乎可以看做是 2 倍！看起来连接控制的效果真是好呀，那么事实真的如此吗？

代码示例风格

代码示例应简洁，配合文字解释，适当添加注释：

public void run() {
    ServiceLoader<Driver> loadedDrivers = ServiceLoader.load(Driver.class);
    Iterator<Driver> driversIterator = loadedDrivers.iterator();
    try{
        while(driversIterator.hasNext()) {
            driversIterator.next();
        }
    } catch(Throwable t) {
    // Do nothing
    }
    return null;
}

善用表格对比

	传统 API 网关	AI 网关
请求响应模型	无流式处理需求	流式处理，SSE 协议支持
内容感知深度	根据 header/query/path	支持 OpenAI 协议，多模型协同

善用引用块

引用块用于突出重要观点、他人言论或文档内容：

> shutdown()：Initiates an orderly shutdown in which previously submitted tasks are executed...
> — JDK 文档

文章类型特点

技术教程类

Architecture First 或 Code First 的选择要明确
层层递进，由浅入深
提供完整可运行的代码示例
章节末尾适当总结

比赛总结类

按时间线叙述优化历程
分享具体的 QPS/性能数据
坦诚分享踩坑和负优化
感谢帮助过自己的人

生活杂谈类

保持真实感，分享真实经历
可以有适度的吐槽和调侃
结尾可以有祝福或感慨

写作禁忌

避免纯翻译腔 - 不要机械翻译英文文档，要有自己的理解和表达
避免过度学术化 - 不要堆砌专业术语而不解释
避免缺乏个人观点 - 要有"私以为"的判断，不能只是复述
避免无故事性 - 技术内容也要有叙事性，避免纯罗列
避免无结尾 - 文章要有明确的收尾和总结
避免不敢表达 - 敢于说"我不太确定"、"个人猜想"，保持真实

参考资料

更多写作风格示例见 references/examples.md

kirito-writing-style