SuperAPI AI 工具集

humanize

写作与研究

查看项目

更新于 10-16 08:37

技能介绍

用途:Humanize 用于把 AI 生成的开发者文本改写得像人写的,覆盖文档、docstring、提交信息、PR 描述和代码注释。它读取上一次 review-ai-writing 的结果,按修复安全性自动分类后应用改动。

主要能力:修复内容、词汇、格式、沟通、填充语和代码文档六类问题。安全修复自动应用,包括删除聊天痕迹、知识截止声明、填充短语、标题重复句、表情、多余加粗,替换高频 AI 词汇(如 utilize 改为 use),删除显而易见的注释和“In today's...”式开场、谄媚语气、无出处论断、过度模糊限定、空泛结论、反问句,以及自然使用 is/are。需人工确认的修复包括宣传性语言、公式化结构、同义词轮换、提交信息夸大、同义反复 docstring、穷举参数说明、this 名词动词句式、低信号 AI 词汇聚集、道歉式错误信息。

使用方式:命令为 /beagle-docs:humanize [--dry-run] [--all] [--category <name>]。--dry-run 只展示不改文件;--all 先对全代码库运行 review;--category 限特定类别,可选 content、vocabulary、formatting、communication、filler、code_docs。执行前检查未提交改动,脏工作区会先 git stash push -u -m "beagle-docs: pre-humanize backup"。需先加载 beagle-docs:humanize 技能,并读取 .beagle/ai-writing-review.json;缺失时若带 --all 会先跑 review,否则报错提示先运行 /beagle-docs:review-ai-writing。结果按文件分组、按行号倒序应用安全修复,避免偏移。需确认项逐条交互 y/n/e/s 处理。git 提交和 PR 等构件不自动修改,只报告待人工处理。修改后校验 Markdown 代码围栏成对、Python 用 ast.parse、TypeScript/JavaScript 用 npx -y acorn --ecma2020;校验失败则 git checkout -- 回退该文件。全部成功后才删除 JSON 报告,失败则保留。

适用场景:清理 AI 生成的 README、注释、docstring、提交信息和 PR 描述。

限制:依赖已有 review-ai-writing 结果与 git 仓库;不自动修复 git 构件;需人工确认的修复不会自动应用;资料未提供安装方式、收费、价格和平台支持信息。