一句话看懂:有开发者把阮一峰《中文技术文档的写作规范》做成了 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 腔检查只能过滤表达层,无法替代事实核对与技术判断。
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
值得关注的后续
一是该 Skill 的 14 条检查规则是否公开细化,能否适配其他语言和文档类型;二是 Claude Code、Grok 之外,主流 Agent 工具是否会原生集成类似规范;三是这类去 AI 腔工具会不会从个人项目走向团队协作和企业内容流程。
来源:@supezen


