duck-review 是一个代码审查技能,定位为“橡皮鸭式”审查,扩展自 caveman-review,并增加了额外的严重级别前缀。它默认保持简洁格式,输出可直接粘贴到 PR 讨论中的一行评论。
用途 该技能用于对代码变更进行审查,输入可以是 diff、PR 文本或粘贴的代码片段。它只输出可执行的发现,不写补丁、不批准或请求更改、不运行 linter 或测试。
主要能力 审查按优先级顺序扫描:安全 → 正确性 → 数据完整性 → 性能 → 测试 → 文档。每条评论使用一行模板:<前缀> <路径[:行号]> — <问题>。修复:<最小安全变更>。评论保持可直接粘贴到 PR 线程。
前缀体系 所有 caveman-review 前缀均适用,并新增以下前缀:
- 📝 doc:文档或注释缺失/过时
- 🧪 test:测试覆盖缺失/过时
- 🔒 sec:安全问题(注入、认证绕过、密钥、SSRF)
- ⚡ perf:性能问题(N+1、不必要的分配、糟糕的复杂度) 使用最强匹配前缀;若多个适用,选择风险最高的前缀。
使用方式
- 确认审查输入存在(diff、PR 文本或粘贴的代码块)。
- 按优先级顺序扫描。
- 仅输出可执行的发现,每条一行:位置、问题、修复方向。
- 使用最强匹配前缀。
- 对于安全或不可逆风险的发现,切换为完整段落(Auto-Clarity),然后恢复简洁评论。
- 如果前缀选择不明确或审查者需要措辞示例,加载 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。