代码合并审查门
将以下提示词粘贴到你的 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 漏检的泄漏