用途:分析当前分支相对基线分支的改动,产出结构化的 PR/MR 标题与正文,包含证据支持;在用户明确批准后,可选地通过命令行创建 PR/MR。
主要能力:收集 git 上下文(状态、分支、日志、差异、远程),从落盘的产物文件中分析功能改动与理由、受影响的文件/目录与测试覆盖信号、风险标记(破坏性变更、配置或依赖变更、已知限制)以及缺失信息;按约定式提交风格起草标题,并按模板生成正文;对每个章节执行链式校验,确保断言可由产物验证,无法验证之处明确标注为未知。
使用方式:先验证 git 仓库上下文并捕获当前分支与工作区状态;若工作区不干净会提示用户并询问是否继续。随后运行收集脚本:BASE_BRANCH="${BASE_BRANCH:-main}" bash scripts/collect_pr_context.sh,读取产物目录与 MANIFEST.txt,并从磁盘分析产物而非将大段 diff 流式输出到对话。分析后起草标题与正文,进行质量门检查,再向用户请求明确批准;批准后从 git 远程检测平台(或在歧义时询问用户)、确认所选 CLI(GitHub 用 gh,GitLab 用 glab)存在且已认证,然后使用批准过的确切标题与正文创建,成功返回 PR/MR URL,失败返回可操作的详情。
适用场景:需要为分支改动自动整理评审友好的 PR/MR 说明、提前暴露破坏性变更与迁移事项、形成测试说明与后续跟进项。
限制:运行时需要 Git CLI 与 mktemp、cat 等 shell 工具;创建 PR/MR 需要 gh 或 glab 且认证有效;任何创建命令前都必须获得用户明确确认,不能擅自创建;信息不足时必须明确标注缺口而非推测。资料未提供具体平台配置细节与脚本完整实现。