SuperAPI AI 工具集

fetch-diff

测试与质量

查看项目

更新于 10-15 20:08

技能介绍

用途:抓取 GitHub 拉取请求(PR)的 diff,并为每行添加旧行号与新行号标注,方便在代码审查中准确放置评论。自动生成的文件(如锁文件、protobuf 生成的 Java)会以屏蔽形式展示,使审查聚焦于手写改动。

主要能力:输出带行号标注的 diff;对自动生成文件显示 [Auto-generated file - diff masked];对已删除文件显示 [Deleted file - diff masked];支持按文件模式过滤。行标注格式为 old_line new_line | <marker> content:仅左侧数字带 - 表示删除行,评论用 side=LEFT、line=old_line;仅右侧数字带 + 表示新增行,评论用 side=RIGHT、line=new_line;两侧都有数字且无标记表示未改动行,评论用 side=RIGHT、line=new_line。

使用方式:脚本为自包含的 PEP 723 脚本,通过 uv run 按需解析依赖,无需安装步骤。基本命令:uv run "${CLAUDE_SKILL_DIR}/scripts/fetch_diff.py" <pr_url> [--files <pattern> ...]。可用 --files 传入一个或多个文件模式,例如 '.py'、'.ts' 或 'src/server/js/*'。GitHub token 会从 GH_TOKEN 环境变量或 gh auth token 自动检测。

适用场景:需要在 GitHub PR 上做代码审查、并希望评论行号准确对应 diff 行时;希望过滤特定类型文件或忽略自动生成文件时。

限制:资料未提供对非 GitHub 平台的支持说明;未提供除 --files 外的其他参数、错误处理、速率限制或私有仓库权限细节;未提供安装以外的配置说明。