SuperAPI AI 工具集

create-pr

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:将未提交的改动暂存、提交、推送分支,并在项目所用的 Git 托管平台上开启拉取请求,全程遵循项目约定与 Conventional Commits 规范。

主要能力:解析参数(可含 skip-checks、工单号如 VGV-123、简短描述或为空);校验阶段自动检测并运行项目的格式化、lint 与测试命令;评估 git 状态并确定目标基础分支;生成单条符合 Conventional Commits 的提交信息(type(scope): subject),可从 docs/plan/ 计划文件或 diff 推断类型,并从分支名提取工单号写入 Refs 行;推送分支;依据 .github/workflows/ci.yaml 在本地运行 CI 检查;生成 PR 标题与描述,支持读取 .github/PULL_REQUEST_TEMPLATE.md 模板并按提交类型勾选 Type of Change,无模板时使用默认模板。

使用方式:以当前分支为源分支,目标为 BASE_BRANCH。关键命令包括 git branch --show-current、git status --short、git diff --cached、git diff、git log <BASE_BRANCH>..HEAD --oneline、git add、git diff <BASE_BRANCH>..HEAD --stat,以及 cat .github/PULL_REQUEST_TEMPLATE.md 2>/dev/null。提交前必须经用户确认,确认后才提交,且提交后不立即推送;推送前同样需用户确认。

限制与注意:若当前分支为 main 或 master 会警告并停止;无暂存或未暂存改动且无领先提交时提示无可提交内容并停止;绝不暂存 .env、.key、.pem、secret、credential、.p12、.jks 等敏感文件;校验或 CI 检查失败时报告错误并停止,除非传入 skip-checks。PR 标题不超过 72 字符,使用祈使语气、无句号、冒号后不大写。具体 CLI 工具检测与推送失败处理需参考技能内附的 references 文档,资料未提供其细节。