用途:检测当前 Git 仓库的远程 URL,为 GitHub 相关集成(如创建 issue)提供仓库定位信息。
主要能力:
- 判断当前环境是否处于 Git 工作树中。
- 读取 remote.origin.url 并解析仓库所有者与仓库名称。
- 判断远程地址是否指向 GitHub。
- 支持 HTTPS 与 SSH 两种远程 URL 格式。
使用方式:
- 运行 git rev-parse --is-inside-work-tree 2>/dev/null 检查 Git 是否可用;若不可用,输出警告“[specify] Warning: Git repository not detected; cannot determine remote URL”并返回空结果。
- 执行 git config --get remote.origin.url 获取远程 URL。
- 解析 URL,提取 owner、repo,并判断是否为 GitHub 仓库。
适用场景:需要在 GitHub 上创建 issue 或其他依赖远程仓库信息的工作流之前,自动识别当前项目对应的 GitHub 仓库。
限制:仅在远程 URL 实际指向 github.com 时才报告为 GitHub 仓库;若 Git 未安装、当前目录不是 Git 仓库或未配置远程,则返回空结果且不报错,相关集成应能降级继续运行。