---

name: gh-project-pr description: Project 级别批量 PR 审查与合并。

gh-project-pr

获取 GitHub Project 中 Issues 与 PR 的映射关系，用于追踪实现进度。

斜杠命令

核心功能

Phase 1: 获取 Project Items

Copygh project item-list <number> --owner <owner> --format json

过滤条件：

• 类型为 Issue（排除 PR、Draft Issue）
• 状态非 Done

Phase 2: 查找关联 PR

对每个 Issue 依次尝试 3 种方式：

1. linked:issue 搜索

   Copygh pr list --search "linked:issue:<N>"
   

2. 分支名匹配

   Copygh pr list --head "feat/issue-<N>"
   # 还会尝试: feature/issue-<N>, fix/issue-<N>, issue-<N>
   

3. Body 引用搜索

   Copygh pr list --search "Closes #<N> in:body"
   # 还会尝试: Fixes #<N>, Resolves #<N>
   

Phase 3: 排序与过滤

使用 sort_by_priority.py 按 priority:p0-p3 进行排序，并默认过滤已合并 PR。

Phase 4: 批量审查 + CI gate + 自动合并（batch_review.py）

当启用自动审查时，batch_review.py 会对每个 PR 执行以下 gate：

• Codex 审查 gate：调用 codex_review.py，通过 codeagent-wrapper --backend codex 返回结构化 verdict（approved/blocking/summary/confidence）
• CI gate：调用 ci_gate.py 等待 checks 全部通过（failure/timeout 将阻断合并）

仅当 “Codex approved + CI success” 同时满足时才会执行合并。合并策略为 squash merge（带 --yes 避免交互），合并成功后会通过 gh api -X DELETE ... 清理远端分支。

用法

主入口 (main.py)

Copy# 预览模式（只执行 Phase 1-3，显示待审查 PR）
python3 scripts/main.py --project 1 --dry-run

# 指定 owner
python3 scripts/main.py --project 1 --owner wscffaa --dry-run

# JSON 输出
python3 scripts/main.py --project 1 --dry-run --json

# 按优先级过滤
python3 scripts/main.py --project 1 --dry-run --priority p0,p1

dry-run 输出示例

CopyFound 4 PRs to review:

| Issue | PR | Priority | Title |
|-------|-----|----------|-------|
| #108 | #112 | P0 | feat: implement analyzer |
| #109 | #113 | P0 | feat: implement codegen |
| #110 | #114 | P1 | deprecate old skills |
| #111 | - | P1 | (no PR) |

Run without --dry-run to execute review.

单独脚本

Copy# 基本用法
python3 scripts/get_project_prs.py --project 1

# JSON 输出
python3 scripts/get_project_prs.py --project 1 --json

# 指定 owner
python3 scripts/get_project_prs.py --project 1 --owner wscffaa --json

# 用户级 Project（与默认行为相同）
python3 scripts/get_project_prs.py --project 1 --user --json

批量审查与合并（batch_review.py）

batch_review.py 需要一个输入 JSON（来自 sort_by_priority.py 或 get_project_prs.py --json），并输出结构化 JSON 结果：

Copy# 仅审查（不合并）
python3 scripts/batch_review.py --input sorted.json

# 审查通过后自动 squash 合并 + 分支清理
python3 scripts/batch_review.py --input sorted.json --auto-merge

# 显式指定 Codex 审查后端（推荐；与 gh-autopilot 对齐）
python3 scripts/batch_review.py --input sorted.json --auto-merge --review-backend codex

兼容性说明：旧版本脚本可能不支持 --review-backend，此时可省略该参数（或由上层编排自动回退）。

输出格式

JSON 格式 (--json)

Copy{
  "mappings": [
    {
      "issue": 108,
      "pr": 112,
      "title": "实现用户认证",
      "pr_title": "feat: add user authentication",
      "state": "open",
      "priority": "p0"
    },
    {
      "issue": 109,
      "pr": null,
      "title": "添加单元测试",
      "state": null,
      "priority": "p1"
    }
  ],
  "stats": {
    "total_issues": 4,
    "with_pr": 3,
    "without_pr": 1,
    "pr_open": 2,
    "pr_merged": 1,
    "pr_closed": 0
  }
}

文本格式（默认）

Copy============================================================
Project #1 Issue-PR 映射
============================================================

统计:
  总 Issues: 4
  有 PR: 3
  无 PR: 1
  PR Open: 2
  PR Merged: 1
  PR Closed: 0

映射列表:
------------------------------------------------------------
  Issue # 108 -> PR # 112 (O) [p0] 实现用户认证
  Issue # 109 -> (no PR)      [p1] 添加单元测试
  Issue # 110 -> PR # 115 (M) [p2] 修复登录 bug
  Issue # 111 -> PR # 116 (O) [--] 更新文档

状态标识：

• O = Open
• M = Merged
• X = Closed

典型用例

1. 追踪 Sprint 进度

Copypython3 scripts/get_project_prs.py --project 1 --json | jq '.stats'

2. 查找无 PR 的 Issues

Copypython3 scripts/get_project_prs.py --project 1 --json | \
  jq '.mappings[] | select(.pr == null) | .issue'

3. 查找待合并的 PR

Copypython3 scripts/get_project_prs.py --project 1 --json | \
  jq '.mappings[] | select(.state == "open") | {issue, pr}'

技术约束

• 需要 gh CLI 2.0+ 并已认证
• 需要 project 和 repo scope 权限
• 启用 Codex 审查时需要本地可用的 codeagent-wrapper，并支持 --backend codex
• 大型 Project 可能需要较长执行时间（每个 Issue 最多 3 次 API 调用）

目录结构

Copy.claude/skills/gh-project-pr/
├── SKILL.md                       # 本文件
└── scripts/
    ├── main.py                    # 主入口（支持 --dry-run）
    ├── get_project_prs.py         # Phase 1-2: 获取 Items 并查找 PR
    ├── sort_by_priority.py        # Phase 3: 按优先级排序
    ├── batch_review.py            # Phase 4: 批量审查 PR
    ├── update_status.py           # Phase 5: 更新 Project 状态
    └── generate_report.py         # Phase 6: 生成报告

相关 Skills

• gh-project-implement: 批量实现 Project Issues
• gh-project-sync: 同步 Issues 到 Project