用途
merge-ready 用于将当前分支整理到可供维护者做最终审查的状态。当用户表示某个功能、修复或分支应当“merge ready”,或要求把改动准备好以供审查,或在构建请求后附加该要求(例如“构建 X 并使其 merge-ready”)时使用。如果同时被要求构建某功能,应先完成构建。
主要能力
- 若分支落后于 origin/main,则拉取并合并 origin/main。
- 对照 origin/main 审查分支上的全部内容,包括未提交和未跟踪的文件,确保理解每一项产品决策和功能变更。
- 安全性审查。
- 简洁性审查:在分支最终状态下,哪些代码可以删除或简化;是否因不太可能的边缘情况导致过度工程。该技能倾向于删除代码。
- 检查 API 和 SDK(TanStack、DataForSEO、Autumn、Cloudflare)的使用是否地道,留意重复实现已有功能、绕开并不存在的限制、或为不需要的东西付费的代码。仅在看起来有问题时才查阅文档。
- 检查是否存在严重的计费滥用方式,例如不付费获取积分、付费功能或提供商调用。忽略没人会利用的小漏洞。
- 除此之外,按认为最佳的方式进行审查,优先把时间花在一旦出错危害最大的部分。仓库的
docs/maintainers/review-guidelines.md列出了仓库的不变量以及那些看起来有问题但实际是有意为之的事项。
使用方式
- 修复真实存在的问题,边做边提交。
- 在本地让
pnpm ci:check和pnpm test通过,然后推送。这些本地运行可替代 CI,因此不必等待 GitHub CI 完成。 - 针对 main 创建或更新 PR。PR 描述使用
simple-issue-description格式,将留给维护者判断的内容放在 Extra context 下。 - 绝不合并。最终审查由维护者完成。
适用场景
- 用户明确要求将分支或改动整理为“merge ready”。
- 用户要求把改动准备好以供审查。
- 用户在构建请求后附加该要求,例如“构建 X 并使其 merge-ready”。
限制
- 该技能不会执行合并操作,合并决定权归维护者。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。