用途
review-sweep 用于处理 PR 评审反馈,目标是在同一分支上减少重复的后续评审。
它的核心做法是:把每条评审评论当作一次机会,用来推断一条更广泛的规则,然后在该规则明显适用的当前 diff 其他位置应用这条规则。
主要能力
- 提取底层规则,而不只是做字面上的行内修改。
- 当规则客观且歧义较低时,在当前 diff 的所有位置修复同一模式。
- 避免把评审建议机械照搬到不相关的代码上。
- 当反馈涉及架构或口味时,一次性做出决定。
- 倾向于一次连贯的后续重构,而不是许多细碎的复制粘贴式修复。
- 让影响范围与置信度成比例。
- 如果建议的扫描依赖另一个 PR 或尚未完成的上游变更,明确指出而不是猜测。
适合扫描的目标
安全性规则:
- 输入校验
- 索引或键的守卫
- 危险属性过滤
- null 或 undefined 处理
重复出现的文档问题:
- 解释不完整
- API 文档与概念文档之间的偏差
- 缺少权衡或使用指引
重复出现的代码形态问题:
- 冗余类型转换
- 别扭的条件判断
- 重复的辅助函数模式
- 同一接缝处重复或缺失的注释
重复出现的测试问题:
- 脆弱的初始化
- 过于具体的选择器
- 应在类似测试中存在的恢复性断言
不推荐的扫描目标
- 没有明显可读性收益的命名偏好
- 没有仓库证据支撑的大范围架构变更
- 只能弱泛化的主观风格选择
- 仅仅为了满足局部便利而扩大公共 API 的改动
- 任何无法用一句话解释清楚的东西
使用方式
工作流:
- 阅读评审评论并分类:安全性、文档清晰度、代码形态清理、测试健壮性、架构或口味。
- 用一句话写下推断出的规则。
- 在当前 diff 的其余部分搜索同一模式。
- 将发现分为:明确适用、可能适用、不适用。
- 仅自动应用明确适用的集合。
- 对于可能适用的集合,做一次明确的决定并给出理由。
- 直接验证被修改的接缝。
- 在交接中区分:你处理的原始评论、你由此推断出的额外 diff 级修复。
输出规则:在总结工作时,要让人明显看出你不只是字面地回答了评论。说明你推断出了什么更广泛的规则,以及在 diff 的其他哪些位置应用了它。
适用场景
适用于处理 PR 评审反馈、并希望减少同一分支上重复后续评审的场景。
限制
资料中未提供关于该技能具体实现、安装命令、收费或价格、支持平台等信息,暂未提供。