SuperAPI AI 工具集

pr-validity

编程与开发

查看项目

更新于 10-16 08:10

技能介绍

用途:分析拉取请求(PR)的有效性,识别 PR 引入的重复、冗余或行为不一致的代码,并检查 PR 描述与关联 issue 的质量。全程只读,不修改代码。

主要能力:

  • 解析目标 PR(可通过参数指定 PR 号,或从当前分支自动识别),获取 diff 并提取新增的函数、类、组件、方法、常量等构造。
  • 在现有代码库中做名称匹配、签名比较、结构模式匹配和代码体匹配,用于发现重复实现,并区分代码移动与更新。
  • 将每个构造分类为 New、Duplicate、Duplicate (divergent)、Override、Update、Trivial Overlap 或 Code Movement,并映射严重程度。
  • 检查 PR 描述是否为空/过短、是否缺少摘要章节、是否缺少测试说明。
  • 检查 PR 是否引用 issue,并评估 issue 正文的验收标准质量(复选框、未决问题、正文过短)。
  • 达到阈值时可经用户确认后创建 GitHub issue,标题格式如 [DLC] PR Validity: {n} redundancies in PR #{number},标签 dlc-pr-validity。

使用方式:依赖 gh CLI 与 jq。示例:gh pr view <PR_NUMBER> --json ... 获取 PR 信息;gh pr diff <PR_NUMBER> 获取完整 diff;gh issue view <ISSUE_NUMBER> --repo <OWNER/REPO> --json ... 读取 issue;创建 issue 使用 gh issue create --repo "$REPO" --title "..." --body-file "$BODY_FILE" --label "dlc-pr-validity"。运行前需阅读 ../dlc/references/ISSUE-TEMPLATE.md 与 REPORT-FORMAT.md。若 PR 新增行数达 500+,会先询问用户是分析全部、仅新文件还是中止。

适用场景:代码评审前排查重复实现、识别同名但行为不同的实现风险、检查 PR 文档与 issue 规范程度。

限制:仅分析 PR 及关联元数据,不检测代码库整体项目类型;仅属于 redundancy 类型的发现才计入创建 issue 的阈值,spec-quality 与 pr-description 发现不计入。具体价格、平台支持范围等资料未提供。