阮一峰老师好牛逼 《中文技术文档的写作规范》成为“去除 AI 腔”的规范 https://t.co/DrIvpwQLgw

有开发者把阮一峰《中文技术文档的写作规范》做成了 Agent Skill,让 Claude Code、Grok 等 AI 工具写中文文档时去掉“值得注意的是”“不仅……更……”这类 AI 腔。这既是对 AI 生成内容一次具体的质量修补,也说明“去 AI 味”正在变成可复用的工程需求。

一句话看懂:有开发者把阮一峰《中文技术文档的写作规范》做成了 Agent Skill,让 Claude Code、Grok 等 AI 工具写中文文档时去掉“值得注意的是”“不仅……更……”这类 AI 腔。这既是对 AI 生成内容一次具体的质量修补,也说明“去 AI 味”正在变成可复用的工程需求。

事件核心:发生了什么

开发者 jacklondon 在 X 上发布了一个名为 zh-tech-writing 的 Agent Skill,用于让 AI 写出的中文技术文档更短、更平实、没有 AI 腔。据其描述,规则基于阮一峰《中文技术文档的写作规范》,另加 14 条 AI 腔检查项,安装命令为 npx skills add leter/zh-tech-writing -g,项目已托管在 GitHub。

触发点是 AI 写中文文档时的固定套路:“值得注意的是”“不仅……更……”,以及满篇“强大”“无缝”。这属于大模型在中文语料与指令对齐中形成的表达偏好,而非内容本身的错误。该 Skill 面向 Claude Code 等编码 Agent,让写文档这一环节有可替换的规则约束。

为什么重要

AI 腔本质上是模型在推理与生成时对“安全、通用、显专业”表达的过度加权,结果就是信息密度低、判断缺失。对开发者来说,代码可由 AI 快速产出,但配套文档如果全是套话,交付质量反而被拖累。把写作规范固化成 Skill,等于把“提示词技巧”升级为可版本管理、可分享、可迭代的规则资产。

另一层意义在于生态位置:它建立在 Claude Code、Grok 等 Agent 工具之上,而不是某个闭源模型内部。这说明去 AI 腔的竞争不只在训练侧,也发生在围绕模型的工具层。目前公开信息显示,这类 Skill 的安装与调用门槛较低,容易在开发者之间扩散。

对用户/开发者/创作者的影响

对开发者,这是一条可直接执行的命令,能降低用 AI 生成 README、API 文档、技术说明时的修改成本。对内容创作者和企业技术团队,它提供了一种思路:与其事后人工删套话,不如把写作规范前置成 Agent 的检查规则。对中文技术写作本身,把阮一峰的个人规范转化为可调用工具,也让“短句、平实、少形容词”有了更明确的执行标准。需要注意的是,AI 腔检查只能过滤表达层,无法替代事实核对与技术判断。

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

值得关注的后续

一是该 Skill 的 14 条检查规则是否公开细化,能否适配其他语言和文档类型;二是 Claude Code、Grok 之外,主流 Agent 工具是否会原生集成类似规范;三是这类去 AI 腔工具会不会从个人项目走向团队协作和企业内容流程。

来源:@supezen

celebrityanime
celebrityanime
文章: 25448

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注