pr-forge v3.0

AI 代码变更安全网关 — Agent 修改代码必须走 PR 审查，验证通过后方可合并

pr-forge 是一套 MCP (Model Context Protocol) 工具集，为 AI Agent 提供 PR 审查安全网关。Agent 通过 9 个 MCP 工具完成从获取 PR 上下文、运行验证、生成审查报告到合并的全流程，所有操作受两层门禁（事实层 + 审查意见层）保护。

安装

# 一键接入
npx pr-forge init

# 环境诊断
npx pr-forge doctor

init 自动检测项目类型并生成 .pr-forge/config.json，将 token 存入 ~/.pr-forge/credentials，配置 .claude/mcp.json 和 ~/.codex/.mcp.json。

MCP 工具 (9 个)

| # | 工具 | 说明 | |---|------|------| | 1 | get_pr_context | 获取 PR 元数据（title/state/draft/SHA/branch/author） | | 2 | get_review_status | 读取各 phase Check Run 结论 + 完整审查报告（含聚合状态），支持 branch 参数 | | 3 | get_pr_diff | 获取 PR unified diff | | 4 | get_file_content | 获取仓库文件内容 | | 5 | commit_and_push | 提交修复并推送到 PR 分支（自动创建 PR、支持 reviewer 指派、返回 pr_number） | | 6 | merge_pr | 合并 PR（两层门禁：事实层聚合 + 审查意见） | | 7 | run_pr_checks | 执行 config.json 的 check 命令（多阶段），各 phase 独立写 Check Run | | 8 | set_conclusion | 修改 Check Run 整体结论，附带审查报告（自动校验 SHA 防过期） | | 9 | get_review_plan | 动态生成审查步骤清单（无参数返回全部 open PR，支持 reviewer 过滤） |

多 Agent 协同

任何 Agent 可提交、审查、合并。提交时通过 reviewer 参数指定审查者（写入 PR body 的 <!-- pr-forge-reviewer: 张三 --> 标记），get_review_plan(reviewer="张三") 自动筛选需处理的 PR。所有操作受两层门禁保护。

GitHub App 授权

pr-forge auth 首次运行时通过 Manifest Flow 创建 GitHub App。后续运行检测已有凭据，调用 GET /app 验证 App 仍有效后直接复用，无需重复授权。App 被删除后运行时自动检测并提示重新授权。

安全模型

• config.json 防篡改：SHA256 hash 对比 .pr-forge/.approved
• Token 存储：读 ~/.pr-forge/credentials，文件权限 0o600，目录 0o700
• 并发控制：run_pr_checks 文件锁 pr-{n}.lock + PID 验活 + 死锁恢复

平台支持

| 能力 | GitHub | Gitee | |------|--------|-------| | 验证结果 | Check Runs API | Commit Status API | | 审查报告 | Check Run output | PR comment | | 合并阻断 | 分支保护规则 | 仓库 CI 检查 |

要求

• Node.js >= 20

License

MIT