关于 humanizer
humanizer 是一项用于清理 AI 生成文本的写作技能,并按不同场景的指南检查内容。它会自动规范字符,也会标记需要人工改写的惯用表达。
主要功能
- 01规范标点及不可见字符
- 02标记过度使用的措辞和套话
- 03提供 README、邮件、Slack 和提交信息指南
- 04处理文本输入或文件
适用场景
- 01润色 AI 生成的 README
- 02检查邮件中的填充语
- 03分享至 Slack 前清理文本
- 04按风格要求检查提交信息
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hjewkes/ agent-skills --skill humanizer安装后在 Claude Code 中输入/humanizer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/commit-guide.mdemail-guide.mdphrases.txtreadme-guide.mdslack-guide.mdscripts/humanize详细介绍
Humanizer
通过规范字符、标记过度使用的短语,并遵循适合上下文的写作指南,清理 AI 生成的文本。
工作流
- 识别上下文 — 确定你要写的内容:README、电子邮件、Slack 消息、提交消息或一般文档
- 加载指南 — 阅读相应的参考文件(见下表)
- 按照指南撰写 — 起草时遵循语气、结构和长度指南
- 运行脚本 — 将最终文本通过管道传入
humanize,进行机械清理并标记短语 - 检查标记 — 自然地改写所有被标记的短语;不要只删除它们,而要换成浅白的表达
上下文指南
| 上下文 | 参考文件 | 核心原则 |
|---|---|---|
| README | references/readme-guide.md | 直接、客观,先展示命令 |
| 电子邮件 | references/email-guide.md | 在第一句话中说明请求 |
| Slack | references/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