SuperAPI AI 工具集

pr-gfm-validator

编程与开发

查看项目

更新于 10-16 01:06

技能介绍

用途:在创建或编辑 PR 描述时,把仓库相对链接转换为带正确分支的绝对 blob URL,防止因 GitHub 将相对链接解析到基础分支(main)而产生 404。

主要能力:触发时机包括从功能分支创建 PR、讨论 PR 描述内容、出现 GFM 链接或链接校验话题、使用 gh pr create 或 gh pr edit。转换范围为 /path、./path、../path 三类相对路径;跳过 https、http、# 锚点和 mailto 链接。构造格式为 https://github.com/{owner}/{repo}/blob/{branch}/{path}。检测正则为 [([^]]+)]((/[^)]+|..?/[^)]+))。

使用方式:先用 gh repo view --json nameWithOwner --jq '.nameWithOwner' 获取 owner/repo,再用 git rev-parse --abbrev-ref HEAD 获取分支;若处于 main 或 master 则跳过转换。识别并替换相对链接后,用转换后的正文执行 gh pr create --title "..." --body "$CONVERTED_BODY"。完成后校验相对链接已变为绝对 blob URL,外部链接与锚点保持不变。

适用场景:在功能分支上创建 PR 并引用仓库内文档、ADR 或配置文件链接时。

限制与注意事项:未推送的文件的链接仍会 404,需先推送提交;分支名含斜杠时需做 URL 编码;避免重复转换,应检查链接是否已是绝对地址;需在 git 仓库根目录运行,否则 gh repo view 可能失败;正则需注意转义括号。该技能还要求使用中如发现说明错误、参数漂移或需变通,应立即修正本文件并记录演进日志。