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