pdd-pr-batch

name	pdd-pr-batch
description	批量合并多个 Change 为一个 PR，适用于多个小改动打包发布。当用户打包发布、相关功能点一起上线、批量更新配置文档时触发。触发词：批量合并PR、打包发布、多个change合并。
license	MIT
compatibility	需要多个 OpenSpec Change ID
metadata	{"author":"[e-mail]","version":"1.0","parent":"pdd-main"}

pdd-pr-batch

Description: 批量合并多个 Change 为一个 PR。适用于多个小改动打包发布的场景。

Details: 批量合并多个 Change 为一个 PR

Input: 多个 OpenSpec Change ID

使用场景

适用场景:
├── 多个小修复打包发布
├── 相关功能点一起上线
├── 配置文件批量更新
└── 文档批量更新

不适用场景:
├── Change 之间有依赖冲突
├── 需要独立回滚的 Change
└── 不同优先级的 Change

执行流程

1. 验证所有 Change

for each change_id in change_ids:
    ├── 检查 Change 目录存在
    ├── 读取 tasks.md 确认完成
    ├── 检查代码已提交
    └── 记录 Change 信息

2. 创建批量分支

分支命名: batch/{date}

示例: batch/2026-03-21

操作:
├── git checkout main
├── git pull origin main
└── git checkout -b batch/2026-03-21

3. 合并代码

for each change_id in change_ids:
    ├── 找到 Change 对应的 Feature Branch
    ├── cherry-pick 或 merge 该分支的提交
    ├── 解决可能的冲突
    └── 记录合并结果

4. 批量审查

运行所有 Change 的测试:
├── 汇总所有测试用例
├── 批量运行测试
├── 汇总测试覆盖率
└── 生成批量审查报告

审查报告: openspec/batch/{date}/review-report.md

5. 创建批量 PR

GitHub 模式:
├── 推送批量分支到远程
├── 创建 GitHub PR
│   ├── 标题: batch: {title} ({n} changes)
│   ├── 描述: 列出所有 Change
│   └── 标签: batch
└── 记录 PR 编号

本地模式:
├── 创建批量 PR 记录
│   └── openspec/batch/{date}/pr-record.md
└── 记录所有 Change ID

6. 输出结果

输出:
├── PR 编号 / 本地记录路径
├── 包含的 Change 列表
├── 批量审查结果
└── 等待确认

输出格式

## 批量 PR 创建完成

**PR 编号**: #125
**分支**: batch/2026-03-21 → main
**包含变更**: 3 个

### 变更列表

| Change ID | 标题 | 状态 | 审查结果 |
|-----------|------|------|---------|
| c-001-xxx | 权限控制 | ✅ 完成 | ✅ 通过 |
| c-002-yyy | 日志记录 | ✅ 完成 | ⚠️ 1 Warning |
| c-003-zzz | 参数校验 | ✅ 完成 | ✅ 通过 |

### 批量审查结果

| 检查项 | 状态 | 详情 |
|--------|------|------|
| 单元测试 | ✅ 通过 | 45/45 用例通过 |
| 测试覆盖率 | ✅ 82% | 阈值: 70% |
| 代码质量 | ⚠️ 3 Warning | 详情见报告 |
| 冲突检查 | ✅ 无冲突 | - |

### 审查报告

详细报告: `openspec/batch/2026-03-21/review-report.md`

### 下一步操作

- 确认合并: `/pdd-pr-merge --pr-number 125`
- 查看详情: `/pdd-pr-review --pr-number 125`
- 单独处理某个 Change: `/pdd-pr-review c-001-xxx`

参数

参数	类型	必需	默认值	描述
change_ids	array	是	-	OpenSpec Change ID 列表
title	string	否	-	PR 标题
draft	boolean	否	true	是否创建为 Draft PR

冲突处理

检测到冲突

⚠️ 检测到代码冲突

**冲突文件**:
- src/main/java/WorkflowController.java

**冲突 Change**:
- c-001-xxx: 修改了第 45 行
- c-002-yyy: 修改了第 45 行

### 解决方案

1. 手动解决冲突:
   - 编辑冲突文件
   - git add .
   - git commit

2. 跳过冲突 Change:
   - `/pdd-pr-batch c-001-xxx,c-003-zzz` (排除 c-002-yyy)

3. 分开处理:
   - 先合并 c-001-xxx
   - 再合并 c-002-yyy

批量归档

合并批量 PR 后，会逐个归档所有 Change：

pdd-pr-merge (批量 PR)
    │
    └── for each change_id:
            │
            ├── openspec-archive-change {change-id}
            │
            └── 更新 Change 状态

批量归档输出

## 批量 PR 合并完成

**PR 编号**: #125
**合并时间**: 2026-03-21 16:00:00

### 归档状态

| Change ID | 归档状态 | 归档路径 |
|-----------|---------|---------|
| c-001-xxx | ✅ 已归档 | archive/2026-03-21-c-001-xxx/ |
| c-002-yyy | ✅ 已归档 | archive/2026-03-21-c-002-yyy/ |
| c-003-zzz | ✅ 已归档 | archive/2026-03-21-c-003-zzz/ |

### 后续操作

- 查看批量归档: `openspec/batch/2026-03-21/`

目录结构

openspec/
├── changes/
│   ├── c-001-xxx/
│   ├── c-002-yyy/
│   └── c-003-zzz/
├── batch/
│   └── 2026-03-21/
│       ├── pr-record.md
│       ├── review-report.md
│       └── merge-report.md
└── archive/
    ├── 2026-03-21-c-001-xxx/
    ├── 2026-03-21-c-002-yyy/
    └── 2026-03-21-c-003-zzz/

错误处理

有未完成的 Change

❌ 部分 Change 未完成

**未完成列表**:
- c-002-yyy: 2/10 任务未完成

请先完成所有 Change 后再执行批量操作。

Change 不存在

❌ Change 不存在

**无效 ID**: c-004-xxx

请确认 Change ID 正确:
- c-001-xxx ✅
- c-002-yyy ✅
- c-003-zzz ✅
- c-004-xxx ❌ 不存在

与其他技能的协作

pdd-pr-batch
    │
    ├── 被调用方
    │   └── 用户直接调用
    │
    └── 调用方
        ├── pdd-pr-review (查看批量审查)
        └── pdd-pr-merge (批量合并)

最佳实践

推荐批量场景

1. 同类型修复: 多个 Bug 修复一起发布
2. 配置更新: 多个配置文件修改
3. 文档更新: 多个文档修改
4. 依赖升级: 多个依赖版本更新

不推荐批量场景

1. 跨模块修改: 可能影响其他模块
2. 紧急修复: 应该单独快速发布
3. 大改动: 应该独立审查和回滚

---

PR管理规范

详见 pdd-pr-create SKILL.md

---

PDD实施规范引用

本Skill遵循PDD框架实施规范，详见 pdd-framework-design.md 第9章。