SuperAPI AI 工具集

humanize-beagle

写作与研究

查看项目

更新于 10-15 21:39

技能介绍

用途:humanize-beagle 用于把 AI 生成的开发者文本改写得更自然,修复浮夸语言、填充内容、同义反复的文档和机械语气。它基于 docs-style 的写作原则,通常在 review-ai-writing 运行并识别问题后使用,按安全/风险分类应用修复。

主要能力:读取 .beagle/ai-writing-review.json 中的审查结果,按 fix_safety 分为可自动应用的安全修复(如删除对话残留、知识截止声明、填充短语、表情符号、过度加粗、明显代码注释、合成式开头、谄媚语气、模糊权威、过度模糊限定、通用结论、修辞问句、公式化破折号、主题分隔线、标题大小写、弯引号、否定式排比等)和需要确认的修复(如宣传性语言、公式化结构、同义词循环、提交信息夸大、同义反复 docstring、穷举式参数文档、道歉式错误信息、三项排比、内联标题列表、不必要表格、均值回归等)。

使用方式:调用 humanize-beagle 技能,可选参数 --dry-run(预览不修改)、--all(先以 --all 运行 review 再修复整个代码库)、--category <name>(仅修复指定类别:content|vocabulary|formatting|communication|filler|code_docs)。执行前有硬性门禁:G1 要求工作区干净或成功创建 git stash;G2 要求审查文件为含 git_head 和 findings 数组的合法 JSON;G3 要求先读取对应 references/*.md;G4 要求每个修改文件通过类型校验,否则用 git checkout -- "$file" 回退;G5 仅在全部成功后才删除审查文件。安全修复按文件分组、按行号倒序应用;需确认的修复逐条交互提示 y/n/e/s;git 提交或 PR 等产物不自动修复,仅报告。

适用场景:在代码库中批量清理 AI 生成的 README、文档、注释、提交信息等开发者文本。

限制:依赖先前的 review-ai-writing 结果;需要 git 环境;不自动修改 git 产物;校验失败会回退文件;具体效果和平台支持暂未提供。