SuperAPI AI 工具集

engram-branch-pr

编程与开发

查看项目

更新于 10-15 21:50

技能介绍

用途:在 Engram 项目中创建 Pull Request、准备分支提交或协助贡献者开 PR 时使用。核心规则:每个 PR 必须关联一个已批准(status:approved)的 issue,必须且只能添加一个 type:* 标签,所有必需自动检查通过后才能合并;未关联 issue 的空白 PR 会被 GitHub Actions 拦截。

工作流:1) 确认 issue 有 status:approved 标签;2) 按 feat/、fix/、docs/、refactor/、chore/ 等前缀创建分支;3) 实现改动;4) 行为变更需本地运行聚焦回归测试和受影响包测试并记录命令与结果,仅文档变更则 Go 测试记 N/A 并验证文档;5) 检查每个改动路径是否符合 Transient Artifact Policy;6) 使用模板开 PR;7) 添加恰好一个 type:* 标签;8) 推送后等待 GitHub CI 的单元/E2E/lint 及适用平台检查,检查真正运行后再报告结果。

分支命名由 GitHub ruleset 强制,正则 ^(feat|fix|chore|docs|style|refactor|perf|test|build|ci|revert)/[a-z0-9.-]+$,描述须小写,仅允许 a-z、0-9、.、、-。提交信息遵循 Conventional Commits 正则,类型须为 build/chore/ci/docs/feat/fix/perf/refactor/revert/style/test 之一,scope 可选小写,! 表示破坏性变更。PR 正文须含关联 issue(Closes/Fixes/Resolves #N)、唯一类型复选框与标签、摘要、变更表、测试计划和贡献者清单。

限制:六项必需检查全部通过才可合并;Lint、Transient Artifact Check、Windows Setup Test 与 Cloud Sync Wrapper Tests (Windows) 会针对 PR 运行但不属于六项必需上下文,不得将待定检查当作已通过。具体命令包括 git checkout -b feat/my-feature main、git push -u origin feat/my-feature、gh pr create --title "feat(scope): description" --body "Closes #N"、gh pr edit <pr-number> --add-label "type:feature"。其余细节以项目 CONTRIBUTING.md 与模板为准。