用途
unslop 是一个 CLI 工具，用于对文本进行后处理，以程序化方式去除 AI 写作模式。与那些要求智能体在生成时避免 AI 腔调的技能不同，unslop 作为确定性的流水线步骤运行：把文本通过管道输入，得到清理后的文本输出。它适合作为提交文档、发布文章或把任何 AI 生成内容送入生产环境之前的最后一道清理工序。
安装
只需安装一次：
pipx install unslop
# 或
uv tool install unslop
验证：
unslop --version
安装需要 Python 工具链，例如 pipx 或 uv，以进行独立 CLI 安装。
主要能力
- 去除 AI 写作模式：通过 CLI 确定性地清理 AI 生成文本中的典型表达。
--deterministic标志：使输出可复现，相同输入始终产生相同输出。--stdin标志：从标准输入读取，便于组合进 shell 管道。
使用方式
第一步：把文本通过管道传给 unslop
标准清理（不同运行之间可能有细微差异）：
echo "This leverages cutting-edge AI to deliver robust solutions." | unslop --stdin
确定性清理（相同输入 → 每次运行输出相同）：
echo "This leverages cutting-edge AI to deliver robust solutions." | unslop --stdin --deterministic
第二步：在 shell 管道中使用
把任意命令的输出通过管道传给 unslop：
cat draft.md | unslop --stdin --deterministic > clean.md
或与其他工具串联：
cat draft.md | unslop --stdin --deterministic | pbcopy # macOS：把干净文本复制到剪贴板
第三步：集成到提交钩子或 CI
添加到 pre-commit 钩子或 CI 步骤中，在内容发布前对其施加质量门禁：
# 在 .git/hooks/pre-commit 或 CI 脚本中
CONTENT=$(cat docs/changelog.md)
CLEANED=$(echo "$CONTENT" | unslop --stdin --deterministic)
if [ "$CONTENT" != "$CLEANED" ]; then
echo "Changelog contains AI writing patterns. Run: cat docs/changelog.md | unslop --stdin --deterministic > docs/changelog.md"
exit 1
fi
示例
示例 1：清理草稿文档
cat blog-post-draft.md | unslop --stdin --deterministic > blog-post-final.md
示例 2：写作过程中的内联清理
# 写入内容，通过 unslop 管道，再把结果写回
cat README.md | unslop --stdin > README.clean.md && mv README.clean.md README.md
示例 3：提交 PR 前校验
# 检查是否有生成的文档需要清理
for f in docs/*.md; do
ORIGINAL=$(cat "$f")
CLEANED=$(echo "$ORIGINAL" | unslop --stdin --deterministic)
[ "$ORIGINAL" != "$CLEANED" ] && echo "Needs cleanup: $f"
done
适用场景
- 当你有 AI 生成文本准备发布，想要做最后一次清理时。
- 当你在 shell 管道中工作，需要自动执行文本质量约束时。
- 当你编写提交钩子或 CI 步骤，要在内容发布前进行校验时。
- 当你需要在多次运行之间获得可复现的文本规范化时。
- 请求明确匹配其用途：在发布前通过 unslop CLI 后处理 AI 生成文本，去除 AI 写作模式。
最佳实践
- 在 CI 和自动化中使用
--deterministic，确保输出可复现。 - 在最终草稿上运行，而不是中间迭代版本。
- 与 avoid-ai-writing 技能结合使用，同时获得生成时指导和后处理。
- 不要在代码文件上运行——unslop 面向散文，而非源代码。
- 不要在 unslop 之后跳过复核：自动清理偶尔可能改变含义，请阅读输出。
限制
- 仅处理散文式文本——不处理代码、JSON 或结构化数据。
- 无法捕捉事实错误或实质性写作问题。
- 部分替换可能不适合所有语境；发布前请复核输出。
- 需要 Python 工具链，例如 pipx 或 uv，以进行独立 CLI 安装。
安全与安全说明
- unslop 从标准输入读取、向标准输出写入——默认不产生文件系统副作用。
--deterministic模式在本地运行，不进行 LLM API 调用。- 默认 LLM 模式可能使用 ANTHROPIC_API_KEY 或 Claude CLI；对敏感本地文件和 CI 门禁请使用
--deterministic。 - 在固定为确定性模式时，可安全用于 CI 管道和提交钩子。