增量代码审查编排器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_92725383/incremental-code-review。
技能介绍
要解决什么问题
大型仓库里,一次 PR 触发的全量 lint 往往会把与本次改动无关的历史告警一并抛出,审查者和 CI 日志都难判断「是不是我这次引入的」。若把安全与质量门禁绑在合并流程上,更合理的前提是:只对 diff 新增行给出可行动的结论,而不是让 reviewer 在全文件噪音里淘金。
技能如何工作
本技能以 Git 的 --base / --head 划定变更区间,扫描编排器读取 diff 后,仅当问题落在新增行时才写入报告。语言层按扩展名调度:scan_engine.py 在 Python 侧组合 bandit、ruff;TypeScript/JavaScript 走 eslint;Go 走 golangci-lint;Java 走内置启发式规则集(与 ESLint 类工具互补)。另有 30+ 条跨语言规则(如 PY-NO-BARE-EXCEPT、TS-NO-EVAL、GO-IGNORE-ERR),并按 critical / warning / info 分级。
输出支持 Markdown(便于 PR 评论、人工扫读)与 JSON(便于报表、缺陷系统对接)。CI 场景使用 ci_gate.py:通过 --max-critical、--max-warning 与非零退出码决定是否阻塞合并;Agent 场景则拉取报告作为审查上下文。可选外部工具缺失时会对该语言打 [WARN] 并跳过,其它语言仍继续。
适用边界与注意
增量审查不能代替定期全量扫描来摸清历史债务;团队规范可在 rules/rules.yaml 增删规则。Java 侧以启发式为主,深度分析仍要依赖自选静态分析链。执行时注意 skill 文档中的路径约定:scripts/ 相对 skill 根目录解析,目标业务仓库一律用 --repo 传入,避免把扫描根目录指错。
使用场景
- GitHub/GitLab PR 流水线需在合并前仅对本次 diff 新增的 critical 问题失败并阻断
- AI Agent 根据用户指定的 base/head 对仓库跑审查,把 Markdown 报告回传给对话上下文
- Monorepo 一次 PR 同时改 Python 与 TypeScript,需要一份汇总的新增行问题清单
- 发布前对比 `origin/master` 与 feature 分支,生成 JSON 报告供缺陷平台录入
适合人员
- 负责维护 PR 工作流、要用退出码控制合并的门禁的平台/DevOps 工程师
- 管理多语言 monorepo、需要统一增量 lint 编排的技术负责人
- 把静态审查接入 Cursor 等 Agent、需调用 `scan_engine.py` 产出报告的工具集成开发者
- Code Review 时只关心本次提交引入的安全/质量项、不想被全文件历史告警淹没的 reviewer