SuperAPI AI 工具集

gentle-ai-branch-pr

编程与开发

查看项目

更新于 10-15 21:50

技能介绍

用途:在任何变更创建 PR、准备分支提交或协助贡献者打开 PR 时使用。核心规则是每个 PR 必须关联一个已批准的 issue,且恰好一个 type:* 标签;必需 CI 按目标策略通过后才可合并,CodeRabbit 在该策略下可选。无 issue 关联的空白 PR 会被 GitHub Actions 拦截。

目标与授权:用 git remote get-url origin 本地检查来源,确定唯一明确的目标主机与 owner/repo,不得从当前目录推断,也不得假设 main;含糊时停止。对目标主机的任何读取(包括 gh auth status 或仓库元数据)前需获得明确的目的地、操作与凭据/会话授权,不得检查或复用环境中的 SSH agent。读权限不等于写权限。授权后复用本次会话中新鲜的目标绑定证据(issue、默认分支、type 标签、检查结果),过期或不匹配的证据需刷新。

工作流:确认授权目标并核实关联 issue 已批准;与人类决定引用是关闭式还是非关闭式。从目标元数据选择 base,仅在要求时创建 type/description 分支。获授权后用常规提交实现,按合并的 ODD 测试优先策略运行适用测试,对修改脚本运行 shellcheck,并在至少一个 agent 中测试变更的技能。从目标模板与证据准备 PR 正文,另行授权后打开 PR 并添加恰好一个 type:* 标签;检查目标策略要求的 CI,报告待定或失败项,不得宣称可合并。

分支命名必须匹配:^(feat|fix|chore|docs|style|refactor|perf|test|build|ci|revert)/[a-z0-9._-]+$,格式为 type/description,小写、无空格。

PR 正文使用目标仓库的 .github/PULL_REQUEST_TEMPLATE.md,包含关联 issue、PR 类型(勾选恰好一项并加对应标签)、摘要、变更表、测试计划与贡献者清单。不得勾选未验证的复选框。受保护标签需直接指名指令与 MAINTAIN/ADMIN 权限的参与者,不得从一般请求推断授权。超过建议 400 行审查预算时记录人类选择的大小例外理由,不得为凑预算而省略测试。

提交信息必须匹配:^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(([a-z0-9._-]+))?!?: .+,类型到标签有映射建议。

命令与限制:本地检查可用 git remote get-url origin;获目标主机读取授权后用目标绑定的 gh 调用验证元数据与默认分支,禁用隐式 cwd 定位。仅在另行授权已验证的目的地、操作与凭据后,才可显式传 --repo 与 --base 进行推送、创建或编辑 PR。不自动执行命令块作为工作流。具体 CI 作业名与标签可用性取决于目标策略,资料未提供固定列表。