用途:diff-explain 用于在审查代码前快速理解一个 diff 或 PR 做了什么。当用户粘贴 diff 并问“这是什么”“总结一下”“解释一下”,或分享 PR 链接、分支名希望先快速了解时激活。它不适用于逐行详细审查,那是另一类任务。
主要能力:读取完整 diff 后,按关注点(如修 bug、重命名、新功能)分组,而不是按文件路径罗列;用一段 3 至 5 句的通俗英文说明改了什么、可能为何改、引入了什么风险(行为变更、API 变更、数据库迁移、依赖升级等);如某一点在合并前需特别注意,会追加一行以 Watch out for: 开头的提示。
使用方式:获取 diff 可用 gh pr diff <url-or-number> 处理 PR,或用 git diff <base>...HEAD(默认 base 为 main 或 master)处理本地分支,也可直接使用用户粘贴的内容。技能会先完整读取 diff,再归纳。
限制与规则:不逐文件走查,不用项目符号,只输出散文;diff 超过 500 行时会在首句说明,并只聚焦前 2 至 3 个关注点;不推测提交信息、PR 标题或关联 issue 之外的业务动机;会如实指出疑似 bug、安全问题、缺失测试或破坏性 API 变更,不掩盖问题。输出为一段文字,可带一行 Watch out for: 结尾,无开场白,直接给结论。
适用场景:合并前快速了解不熟悉的改动、审查 PR 前先建立整体认识。具体安装方式、收费与平台支持等信息暂未提供。