关于 slopmonster
SlopMonster 是用于调整和审阅文稿的编辑 Skill,适用于 README、落地页、邮件和脚本。它结合写作模式检查器与上下文编辑指导,并可请求另一个模型复审,同时强调保留事实并进行人工核对。
主要功能
- 01检查五类写作模式
- 02审阅目的、结构与证据
- 03按受众和格式改写
- 04请求另一个模型复审
- 05比较修改并重新检查
适用场景
- 01提升 README 的清晰度和准确性
- 02审阅落地页或邮件文案
- 03检查脚本中的常见写作模式
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ itsssssjack/ slopmonster --skill slopmonster安装后在 Claude Code 中输入/slopmonster确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.gitignoreLICENSEREADME.md.github/workflows/slop.ymlexamples/ridgeline-roofing.mdjasper-live-run.mdgate-sample.txtprompts/cleanse.txtreferences/principles.mdsigns-of-ai-writing.mdsources.mdtools/cleanse.shdeslop.pytest_deslop.pytest_cleanse.sh详细介绍
SlopMonster
根据受众和目的编辑提供的草稿。此工作流适用于 README、落地页、电子邮件和脚本。使用检查器查找已知模式,然后结合上下文审阅文字。得分为 5/5 表示没有匹配到计分模式;这并不能证明文案清晰或准确。
第 1 步:明确上下文并运行检查器
确定读者、文档格式,以及读者需要从文本中获取什么。参考用户的说明和草稿本身。只有在缺失的上下文会实质性影响编辑时,才提出有针对性的问题。
README 应说明项目的用途、使用方法和局限性。销售页面可能需要在开头提出一个问题。电子邮件可能需要一开始就说明请求。选择适合文档的写法。
python3 tools/deslop.py draft.md
python3 tools/deslop.py page.html
python3 tools/deslop.py page.html --view view-site
python3 tools/deslop.py --text "paste a draft"
检查器会评估五个类别:词汇、句式模式、标点、三项列表,以及可能缺乏依据的论证。每个匹配到内容的类别扣 1 分。得分低于 5/5 时,程序会以状态码 1 退出。输入为空也会失败。
对于 Markdown,请使用文件路径,以便按 Markdown 处理代码和引用示例。规则仅针对英语,不会检测输入语言。
第 2 步:审阅并改写
阅读 references/principles.md,了解编辑检查要点;阅读 references/signs-of-ai-writing.md,了解模式目录。
按以下顺序处理草稿:
- 目的和结构。 尽早回答读者的首要问题。删去重复的引子和会延迟说明的悬念。让每个段落都聚焦于一个有用的要点,并提供足够的上下文以便读者理解。
- 含义和依据。 检查每个句子是否提供了新信息,以及它是否承接前文。说明论断成立的条件。删去空洞的对比、重复的比喻,以及无助于读者理解的比较。保留事实、技术行为和作者的立场。
- 措辞和节奏。 查看检查器的结果,用直接的措辞替换含糊的表达。把相邻句子放在一起阅读,检查句式是否重复。根据表达的思路调整句子长度。保留有用的列表和标点。
不要通过添加观点、错误、残句或固定数量的短句来刻意营造个性。不要给每个论断都添加数字。只使用作者提供或经适当来源核实的事实。
检查器可能会标记恰当的表达。编辑前请查看实际匹配内容。不要把普通文字藏在代码格式中来提高分数。如果有必要的短语仍触发规则,请向用户说明剩余的检查结果。
第 3 步:请求第二轮编辑
使用与撰写初稿的模型系列不同的模型。这能在面向相同受众、服务相同目的的前提下进行第二轮审阅;接受建议前,请先检查。
| 撰写初稿所用模型 | 命令 |
|---|---|
| Claude | DESLOP_WRITER=claude tools/cleanse.sh draft.md > cleansed.md |
| GPT / Codex / ChatGPT | DESLOP_WRITER=gpt tools/cleanse.sh draft.md > cleansed.md |
| Gemini | 使用任一命令,选择已安装的其他厂商 CLI。 |
脚本会使用所选 CLI 配置的模型和 prompts/cleanse.txt。CLI 必须已安装并完成身份验证。如果无法使用,请在其他模型系列的聊天中使用提示词和初稿。如果无法访问第二个模型,请说明未完成这轮审阅,并继续进行编辑审查和本地检查。
标准输出包含编辑后的文稿。标准错误包含修改说明。 如需同时保留两者:
DESLOP_WRITER=gpt tools/cleanse.sh draft.md > cleansed.md 2> notes.txt
检查命令的退出状态。超时会返回 124。找不到其他厂商的 CLI 时会返回 127,并将提示词和输入打印到标准输出;这些输出不是编辑后的初稿。使用文件前,还必须解决其他 CLI 错误。
模型会用 <<<SLOPMONSTER-NOTES>>> 分隔说明。若提示缺少标记,说明说明可能已混入文稿。请检查结果。
第 4 步:比较编辑结果并再次检查
将结果与源文稿比较。检查事实和命令是否有变动,确认链接和占位符仍然保留,并结合上下文阅读开头。检查说明中是否提到了可能删掉必要信息的删减。
python3 tools/deslop.py cleansed.md
目标是在保留原意的同时解决检查器指出的问题。若有合理例外,请予以说明。即使评分为 5/5,也必须进行最终编辑审查。
如果修改正则表达式,请运行 python3 tools/test_deslop.py。如果修改清理脚本,请运行 bash tools/test_cleanse.sh。
事实性声明
切勿捏造证据,包括客户数量、推荐语、评分和结果。如果初稿缺少必要信息,请用 [needs number] 之类的占位符提醒作者。不得将尚未解决的占位符作为已核实的声明发布。
证据规则只能识别“数字+名词”模式,无法核实声明是否属实。只有在核查证据后才能使用 --allow-proof;此选项会保留警告,但取消相应的评分扣分。
输出
按要求返回改写后的文稿,或保存编辑后的成品。然后用最多五条简短说明解释实质性改动和检查结果。说明第二轮模型审阅是否完成。让任何尚未解决的声明或仍未处理的检查器问题清晰可见。不得声称此次编辑证明了文稿由人类撰写。