用途:为当前分支创建拉取请求(PR),并配套执行预检查、自动化审查与 changelog 更新。
主要能力与流程:
- 预检查:运行 git status,若存在未暂存改动、未跟踪文件或当前分支为默认分支 main 则停止并报错;通过 git merge-base main HEAD、git log --oneline <merge-base>..HEAD 判断是否为堆叠 PR(父分支已有开启的 PR);用 git log main..HEAD --oneline 查看提交历史,并用 git diff main...HEAD 或 git diff <parent-branch>...HEAD 获取审查用 diff。
- 自动化 PR 审查(强制,仅纯文档改动可跳过):先按文件分类(docs、ci、config、test、code),再按类别启动并行子代理——正确性与逻辑、风格与约定、安全与性能、测试覆盖。安全子代理仅在 diff 涉及网络/HTTP、用户输入、认证、加密、eval/Function、能力传递、harden()/SES 等敏感区域时启动。
- 审查汇总:将发现分为 blocker、suggestion、nit;有 blocker 时询问用户是自动修复后重审、仍继续创建还是中止。
- 创建 PR:运行 gh pr create,正文包含叙述性描述、变更要点与测试方式说明;堆叠 PR 加 --draft。记录 PR 编号。
- 更新 changelog(强制):判断是否有面向使用者的变更;无则用 gh pr edit <number> --add-label no-changelog 并跳过;有则按 docs/contributing/updating-changelogs.md 更新,从使用者视角描述、合并同类变更、拆分无关变更、链接 PR 编号,提交信息为 "docs: Update changelogs" 并推送。
适用场景:在 metamask/ocap-kernel 仓库中需要规范化创建 PR、执行多维度自动审查并维护 changelog 时使用。
限制:依赖 git 与 gh 命令行环境;审查子代理的启动条件与项目约定(如 CLAUDE.md)相关;具体安装方式、收费与平台信息暂未提供。