关于 unslop
这是一个用于清理文本中常见 AI 写作模式的技能,同时保留原意和预期语气。它会检查措辞、结构、风格与表达清晰度。
主要功能
- 01替换含糊归因和常见 AI 用语
- 02删去填充语和泛泛结尾
- 03改用朴素、具体的表达
- 04拆分冗长句并优先使用主动语态
- 05保留原意与预期语气
适用场景
- 01润色 AI 生成文本,使表达更清晰
- 02精简技术说明和文档
- 03修改文本时保留原有含义
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hachej/ boring-stack --skill unslop安装后在 Claude Code 中输入/unslop确认已加载。
附带文件LICENSE
详细介绍
Unslop
编辑文本,去除 AI 写作痕迹。
流程
- 检查以下模式。
- 重写。保留原意,并符合预期语气。
需要检测并修正的模式
规则编号是固定 ID,其他技能会引用这些编号。删除规则后,编号会留下空缺。
内容
- 流于表面的 -ing 短语。“highlighting...”“ensuring...”“reflecting...”“showcasing...”“fostering...”。删除这些短语,或补充真实来源。
- 来源模糊的归因。“专家认为”“行业报告显示”“一些评论者认为”。注明来源,或删除。
语言
- **AI 常用词。**Additionally、crucial、delve、enduring、enhance、fostering、garner、interplay、intricate、landscape(抽象含义)、pivotal、showcase、tapestry(抽象含义)、testament、underscore、vibrant。改用平实的词。
- 对“是”的花哨表达。“serves as”“stands as”“boasts”“features”。直接用“is”或“has”。
- **“不只是 X,而是 Y”。**直接陈述要点。
- **凑成三项。**不要强行把想法凑成三项,按自然数量表达。
- **轮换使用同义词。**同一段里不要把同一个人称为 protagonist、main character、central figure、hero。选一个词并重复使用。
- **不恰当的范围表达。**如果 X 和 Y 之间没有有意义的范围,就不要用“from X to Y”。直接列出各个主题。
风格
- **过度使用破折号。**完全避免使用 em dash。只用句号或逗号,不要用括号、en dash 或连字符代替破折号。如果需要分开表达想法,就结束句子或使用逗号。
- **过度使用冒号。**列表或示例前可以用冒号,不要在句中用冒号连接意思。“If you're coming from traditional automation: instead of registering event handlers, you describe conditions”中的冒号没有作用。改写成直接表达要点,不要用对比句式作铺垫。“Describing when the scheduler should fire works best as plain English.”意思不变,也不需要用冒号。
- **过度使用粗体。**不要把每个专有名词或缩写都加粗。
- **列表中使用行内标题。**典型形式是加粗标签后接冒号,且标签重复了句子内容:“Performance: Performance improved...”。应改写为普通段落。加粗引导语以句号结尾,点明主题,后面再补充新信息,则没有问题,例如:“Schema in TypeScript. Tables live in one file.”
- **标题使用首字母大写格式。**使用句子式大小写。
- **装饰性表情符号。**从标题和项目符号中删除。
- **弯引号。**替换为直引号。
沟通痕迹
- **聊天机器人常用语。**删除“I hope this helps!”、“Let me know if...”、“Of course!”、“Certainly!”、“Found the smoking gun!”等表达。
- **谄媚语气。**不要说“好问题!”、“你完全正确!”,直接作答。
填充内容
- **填充短语。**将“In order to”改为“To”。将“Due to the fact that”改为“Because”。删除“It is important to note that”。
- **过度使用模糊措辞。**将“could potentially possibly be argued that it might”改为“may”。
- **泛泛的结论。**不要说“未来一片光明”,而要说明具体计划或事实。
行话
- **抽象隐喻名词。**Substrate、wedge、vector、locus、vantage、nexus、primitive(名词)、harness(隐喻用法)、surface(如“API surface”)、bedrock、scaffolding(隐喻用法)、modality、paradigm、gold-plating、ratchet(隐喻用法)、evacuate(指迁移代码)、endgame、north star、flywheel。这些词听起来专业,但通常可以换成更平实、具体的词。“Substrate”改为“base”。“Wedge in”改为“add”。“Vector”改为“way”或“method”。“Gold-plating”改为“more than the job needs”。“Ratchet”改为该机制的实际名称,或“a limit that only tightens”。“Evacuate”改为“move out”。选择具体的词。
平实表达
- 说明它做什么,而不是它给人的感受。“数据库近在手边”“易读的 SQL”“与架构保持一致的类型”描述的是一种感受。改为说明机制或数字:“
.toSQL()返回发送到数据库的确切字符串”“重命名列会导致构建失败”。想想这句话告诉读者该做什么或该了解什么,然后据此写作。如果无法将它改写成具体指令、事实或数字,就删掉。再检查一次:如果这句话原封不动地出现在其他项目的文档中也成立,那它就没有说明这个项目的任何信息。删掉。 - **缩短或拆分信息密集的句子。**如果读者必须回头才能理解一个句子,就把它拆成两句,或删去从句。每句只表达一个观点。
- **使用主动语态。**优先使用主动语态。留意“is/are/was/were + 过去分词”的结构,并指出动作的执行者:“queries are validated”改为“the compiler validates queries”,“the file is parsed by the loader”改为“the loader parses the file”。只有在执行者未知或确实无关紧要时,才使用被动语态。
- 删掉副词,或换成更有力的动词。“runs quickly”改为“is fast”或具体数字。“significantly improves”改为实测的增幅。若需要副词来支撑一个无力的动词,说明这个动词用错了。
- 优先使用朴素的词语。“utilize”改为“use”,“leverage”改为“use”,“facilitate”改为“help”,“numerous”改为“many”,“in the event that”改为“if”。更花哨的同义词很少更清楚。
- **避免矫饰的表达。**有直白说法时,不要使用比喻或华丽辞藻:格言式表达(“wire it or delete it”)、为制造效果而使用的修辞性片段、拟人化的代码(“the plan holds it”)、比喻性动词(“rides along”“stands on”)、陈词滥调式的铺垫语。“A dial worth turning”改为“a parameter worth varying”。把意思说清楚。规则 26 讨论了比喻性名词。
- **避免过度压缩。**省略冠词、无动词片段、符号表达,以及让读者费力解码而非阅读的缩写。“Parser rejects bad date → exit 2, no write”改为“The parser rejects a bad date, exits with code 2, and writes nothing.”写完整句子,保留冠词和动词,并将箭头和缩写展开写明。
评论
支持 Markdown