roc-no-ai-slop-zh

让 Agent 帮你安装(推荐)

把下面这段话直接发给你的 Codex,或其他能够访问终端和文件系统的 coding agent:

请阅读 https://github.com/RocStone/roc-no-ai-slop-zh/blob/main/README.md 并严格按照其中的“Agent 安装协议”执行:安装 roc-no-ai-slop-zh skill,再把 templates/AGENTS.snippet.md 有机合并到我的全局 AGENTS.md。先检查现有文件和同名 skill,保留已有规则,不要直接覆盖;完成后验证安装结果,并告诉我修改了哪些路径。如果当前客户端不使用 AGENTS.md 或不支持 Agent Skills,请先说明对应机制,再按等价方式安装。

把 README 链接交给 Agent 即可,不需要自己复制命令。

它解决什么问题

roc-no-ai-slop-zh 专门处理 Agent 面向用户的中文回复。它在回复发送前删除 AI 套话、宣传腔、机械结构、模糊归因、价值拔高和排版堆砌,同时保留事实、技术精度、必要限定、用户语气和复杂问题本身的复杂度。

它包含两部分:

  • roc-no-ai-slop-zh/:按需触发的 Agent Skill,负责每条中文回复的发送前检查。
  • templates/AGENTS.snippet.md:长期指令片段,负责让 Agent 持续遵守可读性、认识论严谨性、术语一致性和技术解释规则,并在合适的任务中调用本 skill。

Skill 和 AGENTS.md 片段配合使用更稳定:前者提供具体检查流程,后者让 Agent 知道什么时候必须使用它。

Agent 安装协议

Agent 读取本节后,应执行以下步骤:

  1. 判断当前客户端是否支持 Agent Skills,并找到该客户端实际使用的个人 skill 目录。Codex 通常使用 $CODEX_HOME/skills;未设置 CODEX_HOME 时通常是 ~/.codex/skills
  2. 检查目标目录中是否已有 roc-no-ai-slop-zh。如果存在,先比较内容,再更新;不要直接删除用户的本地修改。
  3. 将本仓库的 roc-no-ai-slop-zh/ 目录完整复制到个人 skill 目录,确保最终路径中的 SKILL.md.../roc-no-ai-slop-zh/SKILL.md,不能多套一层仓库目录。
  4. 找到当前客户端真正读取的全局长期指令文件。Codex 通常是 ~/.codex/AGENTS.md。读取现有内容,把 templates/AGENTS.snippet.md 按主题合并进去:保留已有规则,合并重复项,处理冲突,不要覆盖整个文件,也不要简单地在文末重复追加同类规则。
  5. 检查 SKILL.md 的 YAML frontmatter、skill 名称和内部链接,确认 references/chinese-slop-patterns.md 可读。
  6. 告诉用户安装路径、修改过的长期指令文件、验证结果,以及是否需要重启客户端或新开任务才能识别 skill。

如果客户端不支持 Agent Skills,只合并长期指令片段,并明确告诉用户 skill 本身没有被安装。不同客户端的长期指令文件名称不同,不要假装所有客户端都读取 AGENTS.md

手动安装

1. 安装 skill

下面以 Codex 的默认目录为例:

git clone https://github.com/RocStone/roc-no-ai-slop-zh.git
mkdir -p ~/.codex/skills
cp -R roc-no-ai-slop-zh/roc-no-ai-slop-zh ~/.codex/skills/

检查目录结构:

~/.codex/skills/roc-no-ai-slop-zh/
├── SKILL.md
├── agents/openai.yaml
└── references/chinese-slop-patterns.md

如果你的客户端使用其他 skill 目录,把整个 roc-no-ai-slop-zh/ 目录复制到对应位置。

2. 修改全局 AGENTS.md

先打开 templates/AGENTS.snippet.md,再把其中规则按主题合并到全局 AGENTS.md。Codex 的默认位置通常是:

~/.codex/AGENTS.md

不要直接覆盖已有 AGENTS.md。如果里面已经有“中文回复”“技术解释”或同名 skill 的规则,应合并重复项并保留更严格、含义更完整的版本。

修改后重启客户端或新开一个任务,然后让 Agent 回答一段较长的中文技术问题,检查它是否识别并使用 roc-no-ai-slop-zh

单独使用

支持显式 skill 调用的客户端可以这样写:

使用 $roc-no-ai-slop-zh 检查并最小修订这条中文回复。

也可以要求它检查一段现有中文:

使用 $roc-no-ai-slop-zh 检查下面这段话的 AI 套话和机械结构,只修改真正影响理解与自然度的部分,并保留事实和我的语气。

设计边界

  • 它不是“人类写作检测器”,也不判断文本是不是 AI 生成。
  • 它不把所有文本改成统一、圆滑的所谓“人味”。
  • 它不会为了更具体而编造数字、案例、来源或结论。
  • 代码、命令、日志、公式和引文保持原貌;只整理它们周围的说明。
  • 简单问题仍应简短回答,不需要为了展示 skill 而扩写。

来源与许可

本项目的表达模式参考并改编自 norangehere/no-ai-slop-zh,其上游为 Peter Yang 的 no-ai-slop;在此基础上增加了 Agent 对话发送前检查、中文技术解释、术语一致性、认识论严谨性和 AGENTS.md 长期指令模板。

项目使用 MIT License,并保留上游版权声明。