SuperAPI AI 工具集

dym-humanizer-humanize-files-and-embedded

写作与研究

查看项目

更新于 10-18 01:22

技能介绍

用途 该技能面向两类场景:一是正文已经存在于仓库文件中(如 README、文档、博客文章、发布说明),需要就地改写;二是希望其他任务把 Humanizer 作为写出 PR 描述或提交信息之前的最后一步调用(嵌入式模式)。

主要能力

  • 只改写正文:句子、段落、标题、表格中的说明性文字、叙述性注释可被修改;代码块、YAML frontmatter、数据与数字表格、链接目标(](...))保持不变。
  • 文件模式:给出文件路径后完整执行改写流程,但只把最终版本写回文件,并在聊天中给出简短摘要;不展示草稿与检查过程。
  • 嵌入式模式:仅返回最终文本,不含草稿与检查部分,便于嵌入较长流程而不产生中间输出干扰。

使用方式 命令在 agent 的聊天框中输入,而非 shell;Humanizer 本身没有可从 shell 调用的 CLI。文件模式示例:指明“Humanize 正文部分”并给出路径,如 docs/launch-post.md,或要求重写 README.md 的 “Getting started” 部分并直接写入文件。嵌入式模式需说明嵌入语境,例如先让 agent 为某个 diff 起草 PR 描述,再要求用 humanizer 作为最后一步,且只返回最终文本。

批量处理 没有 --batch 标志,需在对话中逐一列出文件(如 docs/intro.md、docs/faq.md、README.md),并说明逐个就地写入。仓库较大时可先用 shell 过滤出改动文件再粘贴清单,例如:git diff --name-only main...HEAD -- '*.md',以实现只处理刚修改的文件。

安全与验证建议 由于是就地覆盖,建议运行前确认工作区干净:git status --porcelain;运行后用 git diff -- docs/launch-post.md 检查差异,重点看三点:是否有主张(claim)消失、代码块是否被改动、链接目标是否变化。这三处也是该技能自设的边界。

限制 不提供二进制、检查命令或退出码,因而无法作为 CI 门禁;仓库中的 .github/workflows/validate.yml 只校验技能包本身,不能用于校验用户项目文本。若需要自动化的文风检查,需另配文本 linter(如 vale、textlint 等)。该技能是由人在 agent 中触发的一步操作。

未提供的事实 资料未说明支持的文件格式范围、语言、性能与耗时、收费与价格、平台兼容性细节以及使用步骤之外的配置项,这些暂未提供。