PR 自动化助手
语言: English | 简体中文
⚠️ 状态:Reference(参考用,非可执行流程) — PR 生命周期协调(5 步骤 CREATE→REVIEW→APPROVE→MERGE→CLEANUP、>400 行 size gate、CI gate、squash/merge 策略、gh CLI 集成)已于 2026-04-28 移至 adoption layer(XSPEC-095)。此处保留 PR 描述模板、合并策略决策矩阵、auto-review 触发规则供参考。 生命周期协调已移至采用层(XSPEC-095);本文档仅供参考。如需强制执行,请使用你的采用层工具链。
简化从创建到合并的 Pull Request 生命周期。
PR 创建检查清单
| 项目 | 规则 |
|---|---|
| 标题 | <type>(<scope>): <summary>,70 字符内 |
| 描述 | 使用结构化模板 |
| 标签 | 至少一个分类标签 |
| 审查者 | 依 CODEOWNERS 或领域指派 |
| 分支 | 与基础分支同步 |
PR 描述模板
## 摘要
<1-3 个重点描述变更>
## 变更内容
- 新增 / 修改 / 移除 ...
## 测试计划
- [ ] 单元测试通过
- [ ] 手动验证步骤
## 截图
(如有 UI 变更)
合并策略决策
| 策略 | 使用时机 |
|---|---|
| Squash merge | 功能分支,提交记录零散 |
| Merge commit | 发布分支,保留完整历史 |
| Rebase | 线性历史,小幅变更 |
自动审查触发条件
| 触发条件 | 阈值 | 动作 |
|---|---|---|
| PR 大小 | > 400 行变更 | 要求拆分 |
| 无测试 | 0 个测试文件变更 | 阻止合并 |
| CI 失败 | 任何检查失败 | 阻止合并 |
| 过期 PR | > 7 天无活动 | 通知作者 |
| 草稿 PR | 标记为草稿 | 跳过审查者指派 |
工作流程
CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
- Create(创建) — 建分支、提交、推送,并以模板开启 PR
- Review(审查) — 自动化检查 + 人工审查
- Approve(批准) — 所有检查通过,满足必要的批准数
- Merge(合并) — 套用选定的合并策略
- Cleanup(清理) — 删除来源分支,更新关联的 issue
使用方式
/pr - 引导创建当前分支的 PR
/pr create - 使用模板创建 PR
/pr --template - 显示 PR 描述模板
/pr review 123 - 审查特定 PR
下一步引导
/pr 完成后,AI 助手应建议:
PR 操作完成。建议下一步:
- 执行
/code-review进行详细代码审查 ⭐ 推荐- 执行
/commit修正审查发现的问题- 执行
/changelog更新变更日志- 检查 CI 状态 →
gh pr checks
参考
- 核心规范:code-review-checklist.md
- 核心规范:git-workflow.md
版本历史
| 版本 | 日期 | 变更说明 |
|---|---|---|
| 1.0.0 | 2026-03-23 | 初始版本 |
AI 代理行为
完整的 AI 行为定义请参阅对应的命令文件:
/pr
授权
CC BY 4.0 — 文档内容