SuperAPI AI 工具集

caveman-review

测试与质量

查看项目

更新于 10-15 19:58

技能介绍

用途:把代码评审意见写成极简、可执行的一行式评论,减少 PR 反馈噪音,保留真正需要修改的信号。

主要能力与格式:每条发现一行,格式为 L<行号>: <问题>. <修复>.;评审多文件 diff 时用 <文件>:L<行号>: ...。可选严重级别前缀:🔴 bug(行为损坏、会引发事故)、🟡 risk(能跑但脆弱,如竞态、缺空值检查、吞异常)、🔵 nit(风格、命名、微优化,作者可忽略)、❓ q(真实提问,非建议)。

应删除:"I noticed that...""It seems like...""You might want to consider..." 等铺垫;"This is just a suggestion but..."(改用 nit:);"Great work!""Looks good overall but..."(只在顶部说一次);复述该行代码在做什么;"perhaps""maybe""I think" 等模糊措辞(不确定就用 q:)。

应保留:精确行号;用反引号标注精确的符号/函数/变量名;具体修复方案而非"考虑重构";当修复原因不明显时说明 why。

示例:L42: 🔴 bug: user can be null after .find(). Add guard before .email.;L88-140: 🔵 nit: 50-line fn does 4 things. Extract validate/normalize/persist.;L23: 🟡 risk: no retry on 429. Wrap in withBackoff(3).

自动放宽:安全类发现(CVE 级问题需完整说明与引用)、架构分歧(需理由而非一行)、新人上手场景(作者需要 why)时,改用正常段落,之后恢复精简。

边界:仅做评审,不写代码修复、不批准/请求修改、不运行 linter;输出可直接粘贴到 PR 的评论。输入 "stop caveman-review" 或 "normal mode" 可恢复详细评审风格。