petergyang/no-ai-slop · 上手攻略

  • 仓库:petergyang/no-ai-slop
  • 链接:https://github.com/petergyang/no-ai-slop
  • 分类:writing-tools / ai-content-detection
  • 作者:Tom
  • 更新:2026-07-28

这是什么

no-ai-slop 是一个专注于「AI 味」检测和清除的开源工具,更准确地说是一套编辑规则和工作流。它的核心目标不是判断「这段文字是不是 AI 写的」,而是检测并清除文字中 20+ 种常见的 AI 写作模式(smell patterns),同时保留作者本人的声音、节奏和个性。

GitHub Stars 超过 2700,X(Twitter)帖子达到 611K 浏览量、10K+ 收藏,是内容创作者和研究写作者圈子里非常受欢迎的工具。

解决什么问题

用 AI 辅助写作时,AI 生成的内容往往带有「标准化腔调」:开头必有「Here's the thing」,分析必有「pivotal moment」「highlighting the team's commitment」,结尾必有总结性 kicker。这类表达单独看似乎无害,但成篇出现时会让读者本能地感到「假」和「油腻」。

no-ai-slop 的解决思路:把 AI 腔调当成一种可量化、可修复的风格问题来处理,而不是玄学的「AI 味」。它提供了一套精确的检测规则(可独立使用)和一套编辑规则(在 AI 辅助写作流程中使用)。

核心组成部分

仓库包含以下关键文件:

文件 作用
SKILL.md 编辑规则和工作流定义,用于 AI 工具调用
eval.md 自我检验清单,编辑后的文字需通过 25 项 pass/fail 检查
.codex-plugin/plugin.json ChatGPT/Codex 插件元数据
scripts/build_plugin.py 构建并验证插件 ZIP 的脚本

快速安装

安装为 Codex/Claude Code 全局 Skill

在 Codex 或 Claude Code 中粘贴以下指令即可激活 skill:

Install this skill globally: https://github.com/petergyang/no-ai-slop

这实际上是让 AI 工具加载 SKILL.md 中的规则集,不是传统意义上的 npm/pip 安装。

安装为 ChatGPT/Codex 插件

  1. 访问 https://github.com/petergyang/no-ai-slop/releases 下载 validated plugin ZIP
  2. 在 ChatGPT 中加载插件(插件市场可搜索 "no-ai-slop")
  3. 或在 Codex 中通过 plugin 配置引用 .codex-plugin/plugin.json

作为独立工具使用(本地)

# clone 仓库
git clone https://github.com/petergyang/no-ai-slop.git
cd no-ai-slop
# 查看 SKILL.md 内容,按规则手动应用

无独立的 CLI 二进制——工具本身是一套规则体系,需要在 AI 辅助下使用(Codex、Claude Code、ChatGPT 等)。

核心用法

工作流程(作者推荐:25/50/25)

初稿我自己写/口述(50%)
    ↓
AI 编辑(25%)—— 用 no-ai-slop 规则改稿
    ↓
最终人工逐行审阅(25%)—— 我自己把最后一道关

关键原则:AI 是编辑,不是代笔。它负责执行规则、找出模式、提出修改建议;最终决定权在作者手中。

用法一:编辑已有草稿

在支持 skill 的 AI 工具中输入:

/no-ai-slop

[在这里粘贴你的草稿]

返回结果包括: - 改写后的完整草稿(在 AI 腔调处做了最小有效修改) - What changed(简短说明修改了什么)

用法二:检测 AI 腔调(不修改)

/no-ai-slop is this AI slop?

[在这里粘贴你想检查的文字]

返回结果列出检测到的每种 AI 模式,包含: - 具体引文(quoted line) - 简短修复建议

不重写、不评分、不声称「这段是 AI 写的」——只报告检测到的写作模式。

检测的 20+ AI 写作模式

以下模式是 no-ai-slop 的核心检测对象:

模式 示例
Binary contrasts "It's not X. It's Y."
Throat-clearing openers "Here's the thing..."
Faux-insight setups "What nobody tells you..."
Colon reveals "The best part: it learns."
Superficial analysis "...highlighting the team's commitment"
Importance puffery "marks a pivotal moment"
Weasel attribution "experts agree," "studies show"
Fake-strong verbs "serves as a centralized hub"
Synonym cycling the agent, then the assistant, then the tool
Negative listing "Not a X. Not a Y. A Z."
Dramatic fragmentation "That's it. That's the whole thing."

此外还强制执行写作基本功: - 开门见山(Lead with the point) - 主动语态(Active voice) - 理清难句 - 具体数字优先于抽象表述

eval.md 自我检验清单

每次编辑后,AI 会用 eval.md 中的 25 项 pass/fail 检查对照自己的修改结果,必要时回炉重改。关键检查维度包括:

  • 是否保留了作者本人的词汇、节奏、直率和幽默感?
  • 删减是否与实际 AI 腔调成正比,有没有过度压缩导致失去个性?
  • 结论是否以具体观点/行动收尾,而不是总结性重复?
  • 格式是否干净(去掉了 emoji 标题、装饰性加粗等 slop)?
  • 编辑后文字是否仍像「一个敏锐的同事口述出来的」?

与同类对比

工具 能力 局限
no-ai-slop 精准模式检测 + 编辑建议,保留作者声音 需要 AI 工具配合,非独立 CLI
Grammarly 语法/风格检查,无 AI 腔调概念 不针对 AI 味,无法检测上述 20+ 模式
Hemingway Editor 可读性高亮,无 AI 味检测 仅面向英文可读性
AI detector(GPTZero 等) 概率判断是否 AI 所写 误报率高,不给修复建议
LanguageTool 语法/风格 不针对 AI 腔调

no-ai-slop 的差异化定位:不检测作者身份,只检测模式,提供最小有效修改。它不惩罚「AI 辅助」这件事本身,而是专注于让 AI 介入后的文字仍然读起来像人写的。

典型适用场景

  • 用 AI 辅助写稿但不想被读者看出:在初稿后加一轮 no-ai-slop 编辑,去除最明显的 AI 腔调
  • 编辑团队内容把关:内容编辑在发布前用这套规则扫描一遍,降低 AI 味被发现的风险
  • 学术写作(润色后处理):导师/审稿人用此工具在 AI 润色后做最后清洗
  • 品牌内容运营:避免品牌博客/社媒内容听起来「太像 AI 写的」损害可信度

坑与注意

  1. 非独立工具:没有 pip install 或二进制可执行文件,必须配合 Codex、Claude Code 或 ChatGPT 等 AI 工具使用。
  2. 不承诺 100% 检测:20+ 模式是覆盖面最广的常见模式,无法覆盖所有可能的 AI 腔调变体。
  3. 强依赖 AI 模型能力:编辑质量取决于调用的 AI 模型;GPT-4o / Claude 效果通常较好,较小的模型可能遗漏或过度修改。
  4. 中英文差异:规则集主要针对英文写作模式,中文 AI 腔调(如「首先...其次...最后」「毋庸置疑」等)不在本工具检测范围内,中文用户可借鉴其思路但需自行扩展。
  5. eval.md 自检不替代人工:AI 用 eval.md 自检是质量保障手段,最终仍需人阅读确认。
  6. 非版权规避工具:仅清洗风格,不涉及版权内容的处理。

一句话推荐结论

no-ai-slop 是目前最精准的「AI 腔调清洗」方案——20+ 种模式精确检测 + 最小有效编辑,完美嵌入「人写初稿→AI 编辑→人把关」的 25/50/25 工作流,既利用 AI 提效,又不让读者感到「油腻」。