SuperAPI AI 工具集

git-platform

写作与研究

查看项目

更新于 10-15 17:20

技能介绍

用途:为 Git 托管平台操作提供跨平台抽象,自动识别当前项目使用的是 GitHub、GitLab 还是 Bitbucket,并给出各平台等价的 CLI 命令,适合在运行 gh、glab 或平台 API 命令前、创建 issue / PR / MR 或发表评论时、编写 CI/CD 配置时使用。不适用于仅本地的 git 操作(如 git commit、git branch)以及没有托管远程仓库的项目。

主要能力:通过 SessionStart 钩子 detect-git-platform.sh 自动检测平台并写入会话上下文,内容形如 git_platform: github|gitlab|bitbucket, cli: gh|glab, mr_term: pull request|merge request;同时提供命令映射参考,涵盖查看/列出/创建/关闭 issue、评论 issue、查看与创建 PR/MR、列出评论、获取当前 PR/MR、解析线程、仓库信息等操作在 GitHub(gh)与 GitLab(glab)下的对应写法。Bitbucket 无标准 CLI,需使用 REST API(curl)或网页界面,详见 command-mapping 模块。另附术语对照:代码评审单元在 GitHub、Bitbucket 称 Pull Request,GitLab 称 Merge Request;CI 配置分别为 .github/workflows/*.yml、.gitlab-ci.yml、bitbucket-pipelines.yml。

使用方式:检测默认自动完成;如需手动重新检测,可运行 git remote get-url origin、ls -d .github/ .gitlab-ci.yml bitbucket-pipelines.yml,以及 command -v gh / command -v glab 检查 CLI 可用性。执行托管操作的技能应声明依赖 [leyline:git-platform],并从会话上下文读取 git_platform,再按映射表选择命令,CLI 不可用时优雅回退。当平台为 GitLab 时,面向用户的输出、提交信息与评论中应使用 merge request 而非 pull request。认证可参考 Skill(leyline:authentication-patterns) 的 ensure_auth github|gitlab。退出标准为:平台已检测(或明确标记为未知)、所有托管操作使用正确的 CLI 工具、面向用户输出使用符合平台的术语。

限制:资料未提供价格、平台支持范围之外的细节及具体效果说明,均暂未提供。