stop-slop技能文件迭代维护指南:一个AI去味写作技能的完整工程化实践
【免费下载链接】stop-slopA skill file for removing AI tells from prose项目地址: https://gitcode.com/GitHub_Trending/st/stop-slop
stop-slop 是一个专用于清除 AI 写作痕迹(AI tells)的技能文件(Skill File),它通过一套可迭代维护的规则体系,教会大模型识别并删除文本中可预测的"AI 腔"。本文以 stop-slop 为样本,带你完整拆解技能文件如何从单一文档演进为结构化工程:版本如何记录、规则如何分层、扩展点在哪里。
技能文件是什么:一个"可安装"的写作规则包
在接触 stop-slop 之前,先理解它解决的核心问题:AI 生成的文字存在高度可预测的模式——固定句式、空洞副词、戏剧化断句。stop-slop 把这些模式整理成"禁用清单 + 替换建议 + 评分标准",形成一份可以被 AI 助手直接加载的规则包。
它的最小安装方式有四种(见 README.md 的 Quick start 部分):
- 作为 Claude Code 的技能文件夹挂载
- 上传到项目知识库
- 把核心规则复制进自定义指令
- 作为系统提示词的一部分注入 API 调用
💡 关键点:它不是代码,而是一份结构化的自然语言规则。这也意味着它的"工程化"体现在信息组织,而不是函数封装。
三层文件结构:核心规则 + 按需加载
stop-slop 的目录结构是典型的"主文件瘦身、细节下沉"设计(结构图见 README.md):
stop-slop/ ├── SKILL.md # 核心指令(8条规则 + 检查清单 + 评分) ├── references/ │ ├── phrases.md # 禁用短语清单 │ ├── structures.md # 需避免的句式结构 │ └── examples.md # 前后对照改写示例 ├── README.md └── LICENSE这种分层的工程价值在于:
- SKILL.md只保留 8 条核心规则(砍填充词、打破套路结构、用主动语态等)和交付前的快速检查清单,保证主文件短小,加载成本低。
- references/phrases.md承载具体"弹药":清嗓开场白(如 "Here's the thing:")、强调拐杖词("Full stop.")、商务黑话对照表(navigate → handle、game-changer → significant)、全部副词禁令。
- references/structures.md收录结构化套路:二元对比("不是 X,而是 Y")、否定列举、戏剧化断句、伪代理(无生命主语执行人类动作),每条都标注了"问题所在"和"改法"。
- references/examples.md提供 before/after 改写范例,让规则可感知。
从 CHANGELOG 看技能文件的迭代节奏
技能文件同样需要版本管理。stop-slop 的 CHANGELOG.md 只有三次记录,却完整呈现了一个技能文件的典型生命周期:
| 时间 | 类型 | 内容 |
|---|---|---|
| 2025-01-12 | 🚀 初版发布 | 单一文档形式上线 |
| 2026-01-12 | 🔧 结构重构 | 按最佳实践拆分为 SKILL.md + references/(PR #1) |
| 2026-01-13 | ✨ 规则扩充 | 新增短语类目与结构模式 |
这条时间线给出了三条可复用的维护经验:
- 先跑通,再重构。初版不追求结构完美,重构(2026-01-12 那次拆分)放在有真实使用反馈之后进行。
- 重构与内容扩充分离。拆分结构(12 日)和追加规则(13 日)是两次独立提交,职责清晰。
- 每次变更都留痕。即使只有几百行的规则包,也坚持按 Added 分类记录,方便回溯"哪条规则是哪次加的"。
规则扩充的三种典型模式
对照 2026-01-13 的变更记录,可以看到 stop-slop 扩展规则时遵循的模式:
- 补充同族词条:向"清嗓开场白"类目新增 "Here's the problem though" 这类变体,保持类目内聚。
- 新增检测维度:把"绝对化用词"(always、never)和"AI 高频强化词"(deeply、truly、fundamentally)纳入词级模式,扩展了原有的句子级规则。
- 结构化表述:新规则一律写成"模式 + 问题 + 替代写法"三段式,与 references/structures.md 中既有的表格风格保持一致。
这种同构扩展是技能文件可持续维护的关键——新规则不引入新格式,降低 AI 加载后的理解成本。
内置质检机制:评分与快速检查清单
工程化维护不只针对内容,也针对产出质量。stop-slop 内嵌了两道"出厂检验"(见 SKILL.md):
- 交付前快速检查(Quick Checks):12 项可勾选项,覆盖副词残留、被动语态、Wh- 开头句、三连等长句、破折号等高频问题。
- 五维打分表:直接性、节奏、信任度、真实感、密度各 1-10 分,总分低于 35/50 即打回重写。
这套量化机制把"写得自然"这种模糊要求变成了可执行的阈值,是技能文件能持续迭代的底层保障——有度量,才能谈改进。
你可以怎样扩展它
基于 stop-slop 的分层设计,扩展时可以直接套用它的模式:
- 加短语→ 在 references/phrases.md 对应类目追加条目
- 加句式→ 在 references/structures.md 按"模式/问题/改法"三列追加
- 加范例→ 在 references/examples.md 补充前后对照
- 加规则→ 在 SKILL.md 的 Core Rules 或 Quick Checks 中增加一条
- 记版本→ 在 CHANGELOG.md 顶部新增日期条目
小结
stop-slop 的工程化实践可以浓缩为四句话:主文件保持精简、细节下沉到 references、用 CHANGELOG 记录每一次变更、用评分机制保证产出质量。它证明了即使没有一行代码,一份纯文本技能文件同样可以按软件工程的方式迭代与扩展。这套方法适用于任何"给 AI 定规则"的场景——写作规范、评审清单、品牌语调,都值得借鉴。
【免费下载链接】stop-slopA skill file for removing AI tells from prose项目地址: https://gitcode.com/GitHub_Trending/st/stop-slop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考