humanizer 使用教程

3.4万星 Agent Skill,去除AI写作痕迹

⭐ 开源免费

📖 项目简介

humanizer 是一个可移植的 Agent Skill(智能体技能),作用是把文字里「一眼就能看出是 AI 写的」那些痕迹去掉,让它读起来像人写的。作者是 GitHub 用户 blader,2026 年 1 月开源,采用 MIT 协议,目前已拿到约 3.4 万 Star、3.1 千 Fork,最新版本 v2.9.1。

它最特别的地方在于「规则不是拍脑袋定的」。整套判断标准来自维基百科的 Signs of AI writing(AI 写作特征)指南,由维基百科的 WikiProject AI Cleanup 小组维护,是志愿者在清理了数千篇 AI 生成条目之后总结出来的。humanizer 把这份指南拆成 33 条可执行的检测规则,分成内容、语言、风格、沟通、冗词五大类,每一条都配了 Before / After 的对照例子。

整个技能的运行体只有一个 SKILL.md 纯 Markdown 文件,不含任何可执行脚本,也不调用外部接口。这意味着它不依赖某一家的产品:Codex、Claude Code、OpenCode 等任何支持 Skill 机制的智能体都能直接加载,一条命令跨端安装。因为不联网、不上传,你的稿子始终留在本地,消耗的只是你自己智能体的 token。

核心亮点

📋
33 条规则有出处
全部来自维基百科反 AI 清理小组的官方指南,不是作者自己编的经验之谈
✍️
学你的文风
丢几段你自己写的东西给它,它照你的句长、用词、标点习惯改,而不是改成通稿
🚫
绝不编造事实
改写中不会新增原文没有的人名、数字、日期和引用,缺细节就问你或直接省略
🔁
改完自己再审一遍
出初稿后自问「这段还有哪里一看就是 AI 写的」,列出残留问题再改第二遍

🧩 它能做什么、输出什么

项目说明
输入三种方式:① 直接在对话里粘贴文字;② 指一个文件让它就地改写;③ 被别的任务当作中间步骤调用
适用类型博客、公众号推文、口播稿、产品文案、邮件、README、PR 描述、提交信息等散文类文本
输出粘贴模式给「初稿 + 残留问题清单 + 最终稿」;文件模式直接改写原文件并回报改动摘要;嵌入模式只吐最终文本
语言 / 兼容规则与例子以英文写成,但技能本身是给大模型看的自然语言指令,中文稿同样适用;任何支持 Skill 机制的智能体都能加载
规格 / 体量单个 SKILL.md,约 620 行纯 Markdown,无脚本、无依赖、无网络请求
💡
文件模式下它只动散文部分,代码块、frontmatter、数据表和链接地址原样保留,不用担心把代码改坏。

🖥️ 环境要求

环境建议配置
操作系统Windows / macOS / Linux 均可,跟着你的智能体走
运行环境用 skills CLI 安装需要 Node.js(能跑 npx 即可);手动安装则完全不需要
硬件无要求。它本身不跑模型,只是一份给智能体读的指令
无 Node 方案直接把 SKILL.md 复制进智能体的 skills 目录,一样生效
关键依赖一个支持 Skill 机制的智能体,如 Codex、Claude Code、OpenCode
额外费用无。不需要注册、不需要 API Key、不上传任何内容,只消耗你自己智能体的 token

🚀 如何使用

💡
最省事的路径:一条 npx 命令全局装上,然后在对话里说「帮我把这段改得不像 AI 写的」,贴上文字即可。全程不用改配置。
1

准备 Node.js 环境

只有走 skills CLI 安装才需要这一步。在终端里确认能跑通版本号,能出数字就行。跳过这步也可以,见第 3 步的手动安装。

bash node -v
2

一条命令全局安装

官方推荐的方式是用跨智能体的 skills CLI 全局安装,装一次所有项目都能用。装完记得新开一个会话,或者让智能体重新加载技能。

bash npx skills add blader/humanizer --global

装到指定的智能体:

bash # 装进所有已配置的智能体 npx skills add blader/humanizer --global --agent '*' # 只装进某一个,把 codex 换成你用的智能体名字 npx skills add blader/humanizer --global --agent codex # 升级到最新版 npx skills update humanizer --global
参数作用
--global装到全局,所有项目都能用。去掉它就是只装进当前项目,可以提交进仓库分享给同事
--agent '*'装进所有已配置的智能体端
--agent <名字>只装进指定的那一个智能体端
3

没有 Node 就手动装

因为运行体只有 SKILL.md 一个文件,手动装同样有效。在 GitHub 搜索 blader/humanizer,把仓库里的 SKILL.md 下载下来,放进你的智能体存放技能的目录里,新建一个叫 humanizer 的文件夹装它就行。

Claude Code 用户还可以走插件市场:

text /plugin marketplace add blader/humanizer /plugin install humanizer@humanizer

装完之后用 /humanizer:humanizer 调用。

4

基础用法:三种调用方式

装好后不用记复杂语法,说人话就行。三种模式对应三种场景:

text # 方式一:粘贴文字(默认模式,会给你初稿+问题清单+最终稿) /humanizer 把下面这段改得不像 AI 写的: (粘贴你的文字) # 方式二:直接说 帮我把这段文案去掉 AI 味:(粘贴文字) # 方式三:指一个文件,它就地改写 把 docs/launch-post.md 里的正文改得像人写的
模式触发方式它给你什么
粘贴模式在对话里贴文字初稿、残留 AI 味清单、最终稿,三样都给
文件模式指一个文件路径直接改写文件,只回报改动摘要,不刷屏
嵌入模式被别的任务当步骤调用只输出最终文本,不带任何解释
5

进阶:让它学会你的文风

这是最值得用的功能。不给样本,它只会把文字改「干净」;给了样本,它会先分析你的句子长短分布、用词层级、段落开头习惯、标点习惯、口头禅和转折方式六个维度,再照着你的习惯改。

text /humanizer 这是我自己写的东西,先学一下我的文风: (粘贴 2 到 3 段你以前写过的文字) 现在按我的风格改写下面这段: (粘贴要改的文字)
它有一条明确规则:如果你的样本里用「东西」「玩意儿」这类口语词,它就保留,不会给你升级成「元素」「组件」。你的样本优先级高于它自己的风格规则,连它最严格的破折号禁令都能被样本覆盖。
6

结合 Codex 使用

装进 Codex 之后最实用的三种接法:一是写完文档顺手让它过一遍;二是让它改 PR 描述和提交信息,这类文字最容易一眼看出是 AI 生成的;三是把它当作长任务的最后一道工序,前面让 Codex 写初稿,最后自动接一道去 AI 味。

text # 写完文档顺手过一遍 用 humanizer 把 README.md 的正文改得像人写的,代码块别动 # 长任务串起来 先按这个大纲写一篇产品介绍,写完用 humanizer 过一遍再给我
因为技能本身就是一份 Markdown 指令,Codex 加载后是「读懂规则再动手」,不是调用某个黑盒接口,所以它能告诉你每一处为什么改。

🎯 典型应用场景

📱
公众号 / 短视频文案
AI 写的推文一眼假,过一遍去掉排比和空洞收尾
🎙️
口播稿
把书面感的长句拆短,读出来才顺嘴
📄
README 与技术文档
只改散文段落,代码块和链接原样不动
🔀
PR 描述 / 提交信息
专治「本次改动旨在提升……」这种模板腔
✉️
邮件与工作汇报
去掉过度对仗和讨好式开场白
📚
百科与资料整理
规则本就出自维基百科的清理实践,最对口

📈 33 条规则速查

五大类,知道它在查什么,你自己写的时候也能提前避开:

类别条目它在治什么毛病
内容类第 1-6 条硬拔高意义、堆砌媒体背书、-ing 式浅层分析、promotional 促销腔、模糊归因(专家认为)、套路化的「尽管面临挑战但前景广阔」
语言类第 7-13 条AI 高频词、回避「是」改用「彰显/扮演着」、否定式对仗(不仅……更……)、三段式排比、同义词轮换、假区间(从 X 到 Y)、被动语态和无主语碎句
风格类第 14-19、26-33 条破折号、加粗滥用、内联标题式列表、标题大小写、emoji、弯引号、连字符词组、权威腔(归根结底)、路标句(让我们深入了解)、标题后的废话、以改动口吻写文档、强行金句、格言公式、假坦诚开场(说实话?)
沟通类第 20-22 条聊天机器人残留(希望对你有帮助)、知识截止声明与凭空补白、讨好式语气(问得好!)
冗词类第 23-25 条填充短语(为了达成这一目标)、过度模棱两可、空洞的正能量收尾(未来可期)
⚠️
它还专门写了一节「不要误判」:语法完美、用词正式、单独一个破折号、单独一句短句、弯引号,这些单独出现都不算 AI 痕迹。它要求看的是「特征扎堆」,而不是抓单点。同时它列了一批「人写的证据」要求保留,比如具体到离谱的细节、自相矛盾的情绪、年代感的梗、长短交错的句子节奏。

常见问题

Q: 它和网上那些「AI 降重 / 去 AI 率」工具有什么区别?

完全不是一类东西。那些工具的目标是骗过检测器,做法通常是换同义词打乱句式。humanizer 的作者在项目里明确写了:不承诺骗过任何检测器。它的定位是一个文字编辑,规则公开、每条都能查到出处,改完还告诉你为什么改。把它当校对用,别当作绕过检测的手段。

Q: 规则是英文写的,改中文稿有用吗?

有用。这份技能本质上是给大模型看的自然语言指令,不是正则匹配。33 条里绝大部分是写作行为层面的毛病,中文 AI 生成的内容同样会犯,比如硬拔高意义、三段式排比、模糊归因、空洞收尾、加粗滥用、emoji 装饰。少数几条偏英文语法的规则(标题大小写、弯引号、连字符词组)在中文里自然不触发,不影响其余部分。

Q: 装了之后 Codex 会不会把我的代码也改了?

不会。文件模式下它有明确约束,只处理散文部分,代码块、frontmatter、数据和链接地址一律不动。

Q: 它会不会为了让文字更像人写的,就自己编细节?

这正是 v2.9.0 专门修的问题。现在有一条硬性的「不许编造」规则:改写里不能出现原文没有的事实、人名、数字、日期或引用。需要具体细节才能成立的句子,它要么问你,要么写成不带细节的朴素版本。它在自审环节还会专门问一遍「这次改写有没有新增原文里没有的东西」。

Q: 为什么它把我文章里的破折号全删了?

第 14 条把破折号列为最可靠的 AI 特征之一,默认是硬性禁止,会换成句号、逗号、冒号或括号。如果你本来就习惯用破折号,把你自己的文章样本喂给它做文风校准,样本的优先级高于这条规则,它会按你的频率保留。

Q: 要花钱吗?要 API Key 吗?

都不要。它是 MIT 协议的开源项目,本体只有一个 Markdown 文件,不注册、不联网、不上传。你的稿子始终留在本地,唯一的成本是你自己智能体消耗的 token。

Q: 只支持 Claude Code 吗?Codex 能用吗?

能用。早期版本的 frontmatter 里确实只标了 Claude Code 和 OpenCode,但 v2.9.1 专门把不可移植的 frontmatter 去掉了,并把跨智能体的全局安装设为官方推荐方式。仓库的标签里也明确列了 codex 和 cursor。用 --agent 参数指定你的智能体即可。

Q: 改完发现语气太平了,没有原来的味道怎么办?

它有一节叫 PERSONALITY AND SOUL,明确说「没有声音的干净文字和 AI 腔一样容易被认出来」。但这一节只在博客、随笔、观点这类需要个人风格的内容上启用;技术文档、法律条文、参考资料里,中性平实本来就是正确的人类语气,它不会硬塞观点。如果你写的是前者却改平了,给它喂文风样本效果最明显。

Q: 可以商用吗?

可以。MIT 协议,商用、修改、二次分发都允许,保留版权声明即可。