conorbronsdon/avoid-ai-writing

项目介绍

avoid-ai-writing 是一个可移植的 AI 代理写作技能，支持 Claude Code、Codex、OpenClaw、Hermes、Cursor 等代理，用于审计文本中典型的 AI 写作痕迹并改写。规则目录覆盖内容模式（意义夸大、宣传性措辞、模糊归因）、语言模式（词汇替换、回避系动词、同义词轮换）、结构模式（破折号滥用、过渡套话、内联标题列表）和沟通模式（聊天机器人套话、谄媚语气）。提供改写、只检测、原地编辑文件三种模式 README。

除规则外，仓库还内置零依赖的 JavaScript 检测器，把发现的问题折算成 0–100 分；另有一个保留性校验器，检查代码、frontmatter、表格、链接和标题在改写后是否被破坏 detector。同一检测器还驱动 npm CLI、GitHub Actions 门禁和 MCP 服务 MCP 仓库。

适合需要在发布前清理草稿或文档的写作者、维护者和开发者关系团队，以及想要确定性检查而非一次性提示词的人。

快速使用

把技能目录装进代理的 skills 目录。以 Claude Code 为例：

git clone https://github.com/conorbronsdon/avoid-ai-writing ~/.claude/skills/avoid-ai-writing

SKILL.md 要和 references/patterns.md 放在一起，入口文件会先加载规则目录再审计。然后用 /avoid-ai-writing <你的文本> 调用 README。Cowork、OpenClaw、Cursor、Hermes、Codex 各有安装路径；只接受单个规则文件的代理可使用自包含单文件版本 单文件包。

在命令行对文件运行检测器：

npx --package avoid-ai-writing-detector avoid-ai-writing draft.md

CLI 以 JSON 输出完整的 analyzeText() 结果并以 0 退出；用法和 I/O 错误写入 stderr，退出码为 2 npm 包。

使用约束

• 规则和内置检测器针对英文校准。德语、法语、意大利语、罗马尼亚语、瑞典语和欧洲葡萄牙语版本由社区作者单独维护，本项目不负责验证 语言适配。
• 单文件包约 138 KB；部分工具的指令字段容量小得多，粘贴前先核对各工具的大小限制 其他代理。
• 它去除的是 AI 写作痕迹，不是执行出版风格指南。可选的 --style 只应用你提供的规则，且其中一部分能被确定性检查 README。
• 检测分数是写作质量基线，不是作者身份分类器；改写通过不验证含义或事实。
• npm 包只含检测器运行时和 CLI，不含仓库的 scripts/ 工具，后者需要克隆仓库。
• MIT 许可。

HotRepo 点评

在 2026-11-10 的 JavaScript 日榜记录中，仓库为 5,542 星、477 fork，当日新增 42 星，该榜最好名次为第 9。这只是单次快照，只能说明当天位置，不能当作趋势。技术上值得注意的是，规则目录与检测器引擎故意采用不同的类别数——74 个写作模式对 54 个检测器 type 类别——项目给出映射文档而不是强行让二者一致 类别映射。公开自家文档的检测得分，并列出扫描发现的自身缺陷，比单看星数更能说明质量 PROOF。