avoid-ai-writing
conorbronsdon/avoid-ai-writing加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

来看看下面这段话,是不是似曾相识?
"Certainly! Acme Analytics, a vibrant startup nestled in the heart of Boulder's thriving tech ecosystem, has secured $40M in Series B funding — marking a watershed moment for the observability landscape. The platform serves as a unified hub, featuring real-time dashboards, boasting sub-second queries, and presenting a seamless integration layer. Moreover, experts believe Acme is poised to disrupt the market. In conclusion, the future looks bright!"
这是典型的「AI 味」文本——过度修饰的形容词("vibrant"、"thriving")、套路化的转折("Moreover")、空洞的预测("poised to disrupt")、万能的结尾("In conclusion")。读者一眼识破,搜索引擎也可能因此降权。
avoid-ai-writing 是解决这个问题的 AI Agent Skill,让 AI 帮你写的内容脱掉「机器味」,听起来像真正的人写的。
项目来自独立开发者 Conor Bronsdon。他在使用 Claude Code 等 AI 编程助手时发现:AI 生成的技术文档、营销文案、博客文章,总有一股抹不掉的「机器人腔调」。
他决定把「AI 味」拆解成 112 个可枚举的词汇替换规则,加上 74 类检测模式,封装成 AI Agent 可以直接调用的 Skill。项目在 GitHub 上迅速获得 4700+ stars,版本迭代到 v3.36.0。
Rewrite(默认):先扫描全文标记 AI 模式,执行最多两轮编辑改写,最后验证结果,返回一个最终版本。
Detect(检测模式):只标记问题,不做修改。适合只想做审计的场景。
Edit(原地编辑):直接在原文件中精确定位修改,只改动必须改的地方,不动源代码和配置文件。
默认最多两轮编辑——第 1 轮初始改写,第 2 轮修正残留模式。检查(verify)不消耗轮次,但如果触发修改则算入。这个设计解决了「一稿过」的最大痛点。
可选 5 种语气预设:casual / professional / technical / warm / blunt,决定文字「听起来的感觉」。
这是项目最有价值的地方——一张具体到每个词的替换表:
| 类别 | 示例 | 替换为 |
|---|---|---|
| Tier 1A(生成证据) | delve | 删除或改写整句 |
| Tier 1A | tapestry | range / variety |
| Tier 1B(词汇修正) | in order to | to |
| Tier 1B | utilize | use |
| Tier 2(聚类加权) | leverage | use |
| Tier 3短语(密度敏感) | the integration of | 删除或改写 |
Tier 1A 是生成证据——这些词强烈暗示文本来自 AI;Tier 1B 权重较低,不会因改词把文档推向 AI 分类。Tier 3 短语只有在重复出现或多个短语堆叠时才触发,防止误伤。
检测引擎覆盖远超词汇替换的范围:
{{placeholder}})、引用格式泄露([@author2024])、UTM 参数"Sure!" / "Great!" / "Absolutely!" 等 AI 开场白"I have to be honest" 等虚假真诚核心检测引擎发布为独立 npm 包,零依赖,不依赖任何外部服务:
npm install avoid-ai-writing-detector
const AIDetector = require("avoid-ai-writing-detector");
const result = AIDetector.analyzeText("Your text here…");
console.log(result.score, result.label, result.issues.length);
CLI 工具支持文件和管道输入,context 参数调整检测灵敏度。CI / pre-commit 门禁可设置阈值,自动拦截 AI 味超标的文档。默认阈值 6,来自对 376 篇人类文档的基准测试——0 阈值会误杀 31.4%,6 阈值只误杀 1.9%。
作为 AI Agent Skill:git clone 安装后,触发词包括 "remove AI-isms" / "clean up AI writing" / "make this sound less like AI",AI 自动接管整个改写流程。
作为独立 CLI 工具:需要 Node.js >= 18,本地安装 npm 包后直接运行。
4700+ star 和持续迭代到 v3.36.0 说明这个方向确实击中了真实痛点。avoid-ai-writing 把「AI 味」的识别和修正变成了一套可枚举、可配置、可自动化的系统工程,填补了 AI 写作工作流中「生成 → 检测 → 修正」闭环的关键一环。
在 AI 内容爆发式增长的今天,「听起来像人写的」本身正在变成一种稀缺能力——这个项目让任何人都能低门槛地获得它。
# Claude Code / Hermes / OpenClaw 安装
git clone https://github.com/conorbronsdon/avoid-ai-writing ~/.claude/skills
# 触发改写(对话中)
# remove AI-isms from this document
# CLI 独立使用
npm install -g avoid-ai-writing-detector
avoid-ai-writing score your-draft.md
# CI 门禁
npx avoid-ai-writing-gate --glob "**/*.md" --context technical