关于 de-slopify
de-slopify 是一套用于修改带有 AI 写作痕迹的文档、文章和代码的方法,面向写作者与审阅者。它帮助识别风格模式和过度设计,同时避免影响技术含义。
主要功能
- 01AI 写作模式检查表
- 02文章与文档编辑指南
- 03AI 代码异味审查
- 04语气校准与编辑流程
- 05审查任务委派指南
适用场景
- 01发布前审阅 README
- 02编辑 AI 辅助撰写的文本
- 03检查生成代码中的多余抽象
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ oakoss/ agent-skills --skill de-slopify安装后在 Claude Code 中输入/de-slopify确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/before-and-after.mdcode-slop.mdprose-patterns.mdreview-workflow.mdslop-vocabulary.md详细介绍
去除 AI 痕迹
概述
去除 AI 痕迹是一种方法,用于从文档、散文和代码中移除 AI 生成内容的明显特征。大模型会生成统计规律性较强的内容,其特有的词汇、标点习惯和结构模式会让文本和代码显得不够自然。有些模式在大模型输出中的出现频率,比人类写作高出 1,000 倍以上。
适用场景: 发布 README 前、AI 辅助写作之后、文档审查期间、审查 AI 生成代码是否过度设计时,以及提交经大模型修改的散文或代码之前。
不适用场景: 正确性比风格更重要的代码逻辑或算法;精确性比表达风格更重要的技术规范;以及原本由人类撰写且读起来自然的内容。
速查表
| 类别 | 模式 | 修正方法 |
|---|---|---|
| 标点 | 过度使用 em dash | 改用分号、逗号、冒号,或拆分为两个句子 |
| 短语 | “原因如下”/“这很重要,原因如下” | 直接解释原因,不要使用引导语 |
| 短语 | “这不是 X,而是 Y” | 改为“这是 Y”,或重新表述二者的区别 |
| 短语 | “让我们深入探讨”/“让我们开始吧” | 删除;直接进入正文 |
| 短语 | “值得注意的是”/“请记住” | 删除保留语气的措辞;直接陈述事实 |
| 短语 | “其核心是”/“本质上”/“根本上” | 删除;直接说明内容 |
| 词汇 | “深入探讨”“锦绣”“格局”“细致入微” | 换成朴实、具体的表达 |
| 词汇 | “革新”“尖端”“颠覆性” | 换成具体论断,或直接删除 |
| 结构 | 句子长度始终整齐划一 | 长短句交替使用,例如 5 个词的短句和 20 个以上词的长句 |
| 结构 | 列表始终恰好包含 3 项,且排列工整 | 调整列表长度;人类常用 2 项、4 项或奇数项 |
| 结构 | 缺少具体信息的泛泛论断 | 补充姓名、日期、数字或第一人称细节 |
| 迎合 | “问得好!”/“当然!” | 删除;直接回答问题 |
| 元话语 | “让我来梳理一下……”/“让我解释一下” | 删除铺垫;直接展开说明 |
| 结构 | 一句话就能说清的编号列表 | 改用句子;仅在内容确实彼此并列时使用列表 |
| 结尾 | “总而言之”/“总结一下” | 删除,或改为具体的结论 |
| 代码 | 为简单函数添加过多注释 | 删除重复说明代码内容的注释 |
| 代码 | 不必要的抽象和设计模式 | 简化为最直接可用的方案 |
| 代码 | 冗长或描述性过强的变量名 | 使用符合领域习惯的简洁名称 |
| 代码 | 对每个操作都进行防御性错误处理 | 仅在确实可能失败的地方处理错误 |
常见错误
| 错误 | 正确做法 |
|---|---|
| 机械地替换每个破折号 | 结合上下文判断;有时破折号就是合适的选择 |
| 为了风格而编辑代码块 | 专注于正文;保留代码示例和技术语法,不作改动 |
| 为了显得随意而删除所有结构 | 保留标题、表格和列表;只改写正文 |
| 过度修正,导致句子支离破碎 | 编辑后朗读一遍;将失去连贯性的句子重新组合 |
| 未明确目标文风就直接修改 | 开始编辑前,先确定角色、语气和受众 |
| 不阅读内容,直接运行正则替换 | 必须逐行手动审阅;修改方式取决于上下文 |
| 忽略 AI 代码异味 | 检查 AI 生成的代码是否存在过度设计、命名冗长和不必要的抽象 |
| 无条件删除所有大模型常见用词 | 某些被标记的词在上下文中完全自然;请自行判断 |
委派
- 扫描仓库,找出需要消除 AI 腔的文档文件:使用
ExploreAgent - 重写整个文档站点,消除 AI 痕迹:使用
TaskAgent - 规划文档语气指南和编辑工作流:使用
PlanAgent - 检查 AI 生成代码中的冗余模式:使用
code-reviewerAgent
如需从 12 个维度(架构、安全、测试、性能等)系统地审计质量,请使用
quality-auditor技能。
参考资料
评论
支持 Markdown