SuperAPI AI 工具集

pull-request

通用与其它

查看项目

更新于 10-15 23:43

技能介绍

用途:在需要创建或更新 GitHub Pull Request(PR)时自动调用此技能。技能说明称直接使用 gh pr create 可能无法通过校验,因此应通过该技能执行。

主要流程:一是校验分支状态,若当前分支未推送则推送到 origin;若当前分支为 main 或 master,需先与用户确认是否为预期操作。二是分析提交,不按时间顺序逐条查看,而是把提交按逻辑主题和目的分组(例如把 A→A'→B→A''→B' 归为 A、B 两个主题)。三是理解“为什么”,关注改动原因而非仅关注改了什么;若业务背景或动机不清晰,应询问用户而非猜测。四是起草 PR。

用法:使用 gh 命令创建 PR,标题为英文,正文为韩文。标题格式为,若上下文存在 Jira 工单号(如 COREPL-1234),则在标题前加 [TICKET-ID],示例:[COREPL-1234] feat(apps-api): add application type list API。命令示例:gh pr create --title "[TICKET-ID] <English title>" --body "$(cat <<'EOF' ... EOF)"。正文包含 개요(概述)、주요 변경사항(主要变更)、영향 범위(影响范围)三部分,按逻辑主题分组而非罗列提交。

正文准则:以“为什么”为主、按主题描述“改了什么”,避免不必要的技术实现细节;不要包含 Test plan 等技术章节;技术细节应服务于“为什么”。

附加要求:在 bucketplace 组织创建 PR 时,命令中加入 --label PR-by-AI;仅当因缺少该标签导致创建失败时,先用 gh label create PR-by-AI 创建标签再重试。完成后返回 PR URL 供用户查看。

限制:技能未提供更详细的平台兼容性、权限要求或收费信息。