用途:git-diff-summarizer 读取原始 git diff 或 git show 输出,生成可读的结构化变更日志,按文件和变更类型(feat/fix/refactor/chore/docs/test)分组,主要用于节省撰写 PR 描述与 CHANGELOG 的时间,面向个人开发者与团队。
主要能力与流程:从 diff 头部(--- a/file +++ b/file)识别语言与文件类型;提取变更文件、增删行数、改动的函数或类名;为每个变更打上 feat/fix/refactor/chore/docs/test 标签;每个文件写 1–3 条要点;输出带统计数据头(变更文件数、增删行数)的要点式摘要。输出语言跟随用户语言,也支持中文触发,如“总结这个 diff,帮我写 PR 描述”。
用法与限制:输入为纯文本 diff,最多约 2000 行,只做只读文本分析,不执行任何 shell 命令或 git 操作,不联网、不写文件。质量门限:至少 1 行变化,否则提示无变化;至少 1 个文件头,否则无法解析;超过 2000 行只总结前 2000 行并给出截断警告,建议先按文件拆分。二进制文件或图片 diff 会被跳过并注明;无法解析或输入为空时给出提示,一次重试仍失败则转为人工复核。检测到疑似凭据时发出警告。
不适用:生成 commit message(另有技能)、代码解释(用 code-explainer)、PR 评审(用 code-reviewer)。不得推断 diff 未显式展示的意图。