SuperAPI AI 工具集

git-diff-summariser

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:当用户粘贴或指向一段 git diff,并希望获得摘要而非逐行阅读时使用。典型请求包括“总结这个 diff”“为这些改动起草提交信息”“这个 PR 改了什么”。

主要能力:输出四个部分——Summary(一段话说明改动目标)、Changes(按主题分组的要点,标注涉及文件)、Risk(可能破坏的地方,如迁移、认证、公共 API、环境变量、定时任务)、Commit message(单行主题加可选正文,采用 conventional-commits 风格,如 feat(module): …、fix(module): …、refactor(module): …)。还可选运行内置脚本 scripts/count.sh 统计 files_changed、insertions、deletions、binary_files。

使用方式:先获取 diff 内容,用户粘贴或通过 fs_read 读取 .diff/.patch 文件;若有沙箱和 /workspace 中克隆的仓库,可用脚本重新生成 diff。随后可选调用 run_skill_script({name: "git-diff-summariser", path: "scripts/count.sh", stdin: <diff 内容>}) 获取统计,再自行阅读 diff,按文件或逻辑主题分组,最后生成四部分结果,并可提供后续选项:写成 PR 描述、生成测试计划、标记缺失测试。

风格与限制:提交主题用祈使语气且不超过 72 字符;风险部分要诚实,无风险时写“Low — isolated changes to X”;不要重复统计已展示的信息;文件用相对路径引用。不要编造文件名,不确定时重读 diff 头部;未阅读前不要标记为“probably safe”;50 行 diff 不要产出 20 条要点,需与改动规模成比例。