用途：在用户要求合并 PR、检查 PR 是否可合并或完成 PR 工作流时，自动执行完整的合并前校验并安全合并。
主要能力：接受可选 PR 编号参数（/pr-merge 123），未提供时通过 gh pr view --json number --jq '.number' 从当前分支检测；校验 PR 是否为 OPEN、非草稿、可合并；用 gh pr checks 检查 CI/CD，支持 Forgejo CI 双远端项目；用 gh api 检查评审状态（APPROVED、CHANGES_REQUESTED、REVIEW_REQUIRED）；用 gh api repos/{owner}/{repo}/pulls/{number}/files --paginate 查看变更文件，大 PR 避免使用 gh pr diff。
合并方式：支持 squash（-s）、merge commit（-m）、rebase（-r），可配合 -t、-b、-d、--auto 等标志；执行 gh pr merge 前必须获得用户确认。合并后确认状态、切换并拉取目标分支、删除已合并分支，并分析孤立、已合并与过期分支。
适用场景：GitHub 仓库的 PR 合并流程，包括发布分支、里程碑检查、CHANGELOG 与文档同步等后续步骤。
限制：所有检查必须通过，禁止使用 --admin 强制合并、禁止绕过评审、禁止合并有冲突或草稿状态的 PR；文档同步等步骤仅为建议，不自动执行。部分 Forgejo 相关命令在资料中不完整，具体用法暂未提供。