Agent Skills
返回列表
💻

代码合并审查门

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-code-review。

技能介绍

要解决什么问题

合并前的 diff 往往同时牵涉需求是否做对(Spec)和写法是否合规(Standards)。若只跑一份清单,「Convention 全过但实现偏了需求」或「功能对上 issue 却踩了安全/租户隔离」很容易被混在一起,最后只靠主观感觉拍板。

本技能定位在正确性与安全闸门:只对你有把握的问题下结论;拿不准的一律归入 Request Changes。模块 cohesion、抽象层次、死代码等结构议题交给 structural-review;仓库 agent 指令里已由 correctness harness 校验的栈规则(Bun、Tailwind v4、Next.js 16 等)不要在此重复点名。

它如何工作

输入是单个 diff、分支或 PR;通过只读的 git / gh 划定范围。输出是两份并行报告:

  • Standards:安全、多租户/软删过滤、TypeScript 纪律、数据库与事务、错误处理、测试粒度、前端副作用清理、API 契约、Devex 回归、特性开关泄漏等清单项。
  • Spec:对照 issue、用户给定路径或 docs/ / specs/ 中的规格,标出缺项、范围蔓延、以及「看起来像做了但实现不对」的行为。

每条发现带文件、行号、一句话理由,并分桶为 Block Merge / Request Changes / Approve。两条轴分开写(## Standards 与 ## Spec),禁止合并或跨轴重排,避免一轴通过掩盖另一轴失败。

开始前需钉住 fixed point(commit、分支、tag 等);diff 为空则先停下。无可用规格时可跳过 Spec 轴并注明 no spec available。

边界与注意点

本技能只报告、不改文件、不开 PR;深度 OWASP 与依赖 CVE 走 security-audit。像「review 所有 PR」这类批量请求应走 review-dispatch;除显式 /merge force 外不要推断任何会改仓库的合并模式。

使用场景

  • 提交 PR 前想让助手按租户隔离、DTO 校验等清单扫一遍 diff,并给出 Block / Request / Approve 分级
  • commit 里引用了 #123,需要对照 issue 原文检查是否漏需求或有未在规格中的 scope creep
  • 多步 `db.update()` 未包事务,需要在 Standards 轴标为合并不安全并注明文件行号
  • PR 自称功能在 flag 后,但 API handler 未做开关校验,需要按 Feature-Flag 泄漏规则判定是否 Block Merge

适合人员

  • 负责主干质量、要在合并前把安全与 TypeScript/测试硬门槛跑齐的 Tech Lead
  • 写 Nest/Next 多租户服务的后端,担心漏 org filter 或半写入 DB 的 PR 作者
  • 按 issue 交付功能的工程师,需要独立 Spec 报告证明「做对事」而不只是「写法干净」
  • 维护特性开关与发布节奏的工程师,要抓 UI 有 gate 但 API/后台 job 漏检的泄漏