mcpField
H
humanizer

humanizer

github.com/hjewkes生产力439 次安装35 周前更新
代码仓库

关于 humanizer

humanizer 是一项用于清理 AI 生成文本的写作技能,并按不同场景的指南检查内容。它会自动规范字符,也会标记需要人工改写的惯用表达。

主要功能

  1. 01规范标点及不可见字符
  2. 02标记过度使用的措辞和套话
  3. 03提供 README、邮件、Slack 和提交信息指南
  4. 04处理文本输入或文件

适用场景

  1. 01润色 AI 生成的 README
  2. 02检查邮件中的填充语
  3. 03分享至 Slack 前清理文本
  4. 04按风格要求检查提交信息

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill humanizer

安装后在 Claude Code 中输入/humanizer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
commit-guide.md
email-guide.md
phrases.txt
readme-guide.md
slack-guide.md
scripts/
humanize

详细介绍

Humanizer

通过规范字符、标记过度使用的短语,并遵循适合上下文的写作指南,清理 AI 生成的文本。

工作流

  1. 识别上下文 — 确定你要写的内容:README、电子邮件、Slack 消息、提交消息或一般文档
  2. 加载指南 — 阅读相应的参考文件(见下表)
  3. 按照指南撰写 — 起草时遵循语气、结构和长度指南
  4. 运行脚本 — 将最终文本通过管道传入 humanize,进行机械清理并标记短语
  5. 检查标记 — 自然地改写所有被标记的短语;不要只删除它们,而要换成浅白的表达

上下文指南

上下文参考文件核心原则
READMEreferences/readme-guide.md直接、客观,先展示命令
电子邮件references/email-guide.md在第一句话中说明请求
Slackreferences/slack-guide.md简洁——最多 1-2 句话
提交消息references/commit-guide.md使用祈使语气,解释原因而非内容
通用运用所有指南中的常识清晰优先于正式

CLI 参考

命令说明
echo "text" | humanize通过标准输入清理文本
humanize file.md清理文件中的文本
humanize --report file.md输出详细信息及替换次数
humanize --help显示用法

退出代码: 0 = 无需修改,1 = 错误,2 = 发现短语标记(文本仍会被清理)

脚本会自动修复的内容

  • 长破折号 → 空格-连字符-空格
  • 弯引号 → 直引号
  • Unicode 省略号 → 三个句点
  • 不换行空格/不可见空格 → 普通空格
  • 不可见 Unicode 水印字符 → 移除
  • 项目符号字符 → ASCII 连字符

被标记的内容(不会自动修复)

脚本会标记需要人工判断并改写的短语:

  • 警示词: delve、tapestry、seamless、robust、comprehensive 等
  • 模糊措辞: “it's important to note”“it's worth noting”
  • 陈词滥调式开头/结尾: “I hope this finds you well”“feel free to reach out”
  • 过度使用的过渡词: furthermore、moreover、additionally

完整模式列表:references/phrases.txt

评论

支持 Markdown