用途:在合并 lossless-claw 的 Pull Request 前进行安全校验,或在被询问 PR 是否就绪、CI 是否通过、是否要合并/落地 PR、以及执行维护者收尾时使用。
主要能力与工作流:先阅读仓库说明,遵循 AGENTS.md 中关于数据保留、changeset、兼容性和命令报告的规则;若仓库存在确定性合并包装脚本则优先使用。用 gh pr view 获取 PR 元数据,将 headRefOid 作为合并固定点,并在合并前重新读取。使用 gh pr checks 验证所有必需检查在固定 head 上完成且成功,若检查未完成、失败、缺失或对应不同 head SHA,则不合并。涉及包可见、用户可见、文档可见行为、兼容性元数据、配置面或发布行为时,须先解决 changeset 问题,外部贡献者不负责添加 Changesets 元数据,由维护者负责。随后在 HEAD 与固定 headRefOid 完全一致的前提下运行分支审查。合并前搜索开放 issue,检查 closingIssuesReferences,并搜索可能重复或被覆盖的报告。
合并方式:优先使用 scripts/pr-merge verify <PR> 和 scripts/pr-merge run <PR>;手动回退使用 gh pr merge <PR> --squash --match-head-commit "$head" --subject "$title",不使用 --auto。合并后确认状态为 MERGED,记录合并提交,致谢外部贡献者,关闭已确认被修复的 issue,若缺少必需 changeset 则立即创建仅补充 .changeset/*.md 的后续 PR。最终报告 PR 编号与标题、固定 head SHA、检查摘要、审查命令与结果、合并命令、合并提交 SHA、致谢评论 URL、issue 搜索与处理结果、changeset 结果,并按 AGENTS.md 以代码块列出命令与结果。
限制:不得删除、清空或丢弃持久化用户数据;不得绕过失败或待处理的必需检查;不得在未固定 head SHA 的情况下合并;不得因 PR 正文没有 Fixes #... 就假定无相关问题;不得关闭含义不明的 issue,应改为评论或报告不确定性。若 head SHA 在校验与合并之间发生变化,不得合并。官方资料未提供更多收费、平台或使用步骤信息。