SuperAPI AI 工具集

polar-code-review

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:在打开 PR 前,对照 Polar 项目自身才知道的约定、已接受 ADR、可复用代码、API 契约、部署形态和计费领域,审查分支 diff。它不是 bug 猎捕,也不是安全审查,那两项由 /code-review 和 /security-review 负责;本技能只增加它们无法掌握的信息。

主要能力:本技能只是一个路由器,每个视角本身也是可单独运行的技能。始终运行 conventions-check、adr-check、reuse-check、slop-check 四个技能;按触发条件追加:api-surface-review 在涉及 /schemas.py、/endpoints.py、polar/openapi.py、docs/openapi.json、sdk/、clients/packages/client/ 时运行;ship-safety 在涉及 migrations/versions/、**/tasks.py、polar/models/、server/scripts/、删除端点,或 diff 跨 server/ 与 clients/ 且二者存在依赖时运行;billing-review 在命中其 Scope 中列出的计费路径时运行。

使用方式:先获取 diff,运行 git fetch origin main、git diff origin/main --stat、git diff origin/main,得到分支加工作区差异;若 fetch 失败,用 main 代替 origin/main。保留完整 diff,每个智能体都拿到完整内容,而不只是文件名。然后在单轮中为每个选中的技能启动一个独立子智能体,彼此不得等待;使用宿主的通用智能体类型(Claude Code 中为 general-purpose,Cursor 中为 generalPurpose,未暴露时用 general)。每个视角使用相同提示:读取 .agents/skills/<skill name>/SKILL.md 并严格遵循;审查此 diff,只有变更行在范围内,绝不涉及仓库其余部分;插入完整 diff;使用该技能定义的输出格式;只保留高置信度发现;不确定是否为缺陷时放入 Question 而非断言。各技能声明的非职责范围避免了视角重叠。adr-check 沿用其更简格式:或输出 No violations,或列出 ADR id、file:line、破坏内容与修复方式,其发现映射为 🔴。

合并与报告:去重,一行一条发现;两个视角命中同一行时优先级为 billing-review → api-surface-review → ship-safety → adr-check → conventions-check → reuse-check → slop-check。显式呈现冲突,不静默取舍。削去填充内容。报告固定分节:Polar Review、🔴 Blocking、🟠 Should fix、🟡 Questions、🧹 Delete、Notes、Coverage、Verdict。Notes 写入 ship-safety 的部署说明与 api-surface-review 的接口变化;两者都未运行时省略。Coverage 说明已运行与因无匹配路径而跳过的技能。Verdict 为 ✅ APPROVED 或 ❌ CHANGES REQUESTED 并给出计数;任一 🔴 即 CHANGES REQUESTED,仅 🟠 时需给出倾向及理由。🟡 部分预期有内容,Polar 的审查大多以提问形式呈现。

限制:不做 bug 猎捕,不做安全审查,也不验证发现或自动应用修复;这些由 /code-review 与 /security-review 承担。审查范围仅限变更行。