SuperAPI AI 工具集

duck-review

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

duck-review 是一个代码审查技能,定位为“橡皮鸭式”审查,扩展自 caveman-review,并增加了额外的严重级别前缀。它默认保持简洁格式,输出可直接粘贴到 PR 讨论中的一行评论。

用途 该技能用于对代码变更进行审查,输入可以是 diff、PR 文本或粘贴的代码片段。它只输出可执行的发现,不写补丁、不批准或请求更改、不运行 linter 或测试。

主要能力 审查按优先级顺序扫描:安全 → 正确性 → 数据完整性 → 性能 → 测试 → 文档。每条评论使用一行模板:<前缀> <路径[:行号]> — <问题>。修复:<最小安全变更>。评论保持可直接粘贴到 PR 线程。

前缀体系 所有 caveman-review 前缀均适用,并新增以下前缀:

  • 📝 doc:文档或注释缺失/过时
  • 🧪 test:测试覆盖缺失/过时
  • 🔒 sec:安全问题(注入、认证绕过、密钥、SSRF)
  • ⚡ perf:性能问题(N+1、不必要的分配、糟糕的复杂度) 使用最强匹配前缀;若多个适用,选择风险最高的前缀。

使用方式

  1. 确认审查输入存在(diff、PR 文本或粘贴的代码块)。
  2. 按优先级顺序扫描。
  3. 仅输出可执行的发现,每条一行:位置、问题、修复方向。
  4. 使用最强匹配前缀。
  5. 对于安全或不可逆风险的发现,切换为完整段落(Auto-Clarity),然后恢复简洁评论。
  6. 如果前缀选择不明确或审查者需要措辞示例,加载 references/review-comment-examples.md。

输入输出示例 输入:“review this diff” 输出: 🧪 test: src/auth/session.ts:88 — refresh-token expiry path untested. Fix: add test for expired refresh token returning 401. 📝 doc: api/openapi.yaml:210 — response schema omits new error_code field. Fix: document field in 401 schema.

输入:“review this” + 用户输入拼接的 SQL 字符串 输出: 🔒 sec: db/userRepo.ts:44 — SQL built from raw user input enables injection. Fix: parameterize query placeholders and bind values.

边界情况

  • 未提供 diff 或代码:在评论前先询问具体的审查目标。
  • 大型重构:优先报告影响最大的发现,避免行级噪音。
  • 不确定的发现:提出一个澄清问题,而不是编造确定性。
  • 同一行有多个问题:当修复方式不同时,拆分为多条评论。
  • 安全问题与风格问题混合:先报告安全问题,风格问题可选。

Auto-Clarity 在安全发现、架构分歧、入门场景中放弃简洁模式,写完整段落,之后恢复简洁。

限制 仅做审查。不写补丁、不批准或请求更改、不运行 linter 或测试。输出评论可直接粘贴到 PR。