用途:将 iOS SDK 的发布 diff 转成发布就绪报告,供 iOS 团队评审。需先收集 source ref(上一个已发布分支或标签)、destination ref(候选发布分支或标签)、repo root,以及 changelog 路径(未提供则搜索 CHANGELOG.md、CHANGELOG、ReleaseNotes*、docs/releases/ 等)。
主要能力:先用 git rev-parse、git merge-base、git diff --stat、git diff --name-status、git log --oneline --no-merges 搭建本地 diff 地图,按公共 API、运行时行为、构建与依赖、测试、文档与 changelog、示例应用分组;再按互不重叠的问题拆分给子代理(changelog 校验、子系统评审、回归与测试覆盖、手工 QA 场景起草),不支持并行时改为顺序执行并声明限制。
校验要点:每条 changelog 是否有代码或测试支撑、范围是否被高估或低估、是否遗漏破坏性行为、迁移或发布注意事项。回归评审关注被修改路径的行为变化、被删弱测试、公共 API 语义变化、错误处理与重试、线程与生命周期、配置与权限、示例应用漂移,每条风险标注确认/高度怀疑/待人工验证,并给出修复或验证建议。
输出:固定为三节——变更摘要、潜在回归与所需修复、手工 QA 测试场景;每条 QA 场景需含前置条件、步骤、通过标准与失败信号。报告应同时使用 ref 名与解析后的 SHA,显式说明不确定性与采样范围。
限制:依赖本地 Git 检出与 git 命令;无本地 Git 时说明无法按设计运行,可改用导出的 diff 与 changelog 产物,或进行低置信度评审。