用途:让代码审查评论简洁、可执行,每条发现写一行,格式为位置、问题、修复。位置写作 L<行号>: 或多文件 diff 时写作 <文件>:L<行号>:。
主要能力:可选严重级别前缀,便于混合场景区分——🔴 bug 表示行为损坏、可能引发故障;🟡 risk 表示可用但脆弱(竞态、缺少空值检查、吞掉错误);🔵 nit 表示样式、命名、微优化,作者可忽略;❓ q 表示真实提问而非建议。保留精确行号、用反引号标注确切符号/函数/变量名、给出具体修复;若修复原因不明显则说明原因。
写法要求:删除“我注意到……”“好像……”“你可以考虑……”等铺垫,删除“只是建议”改用 nit:,删除“做得好”或“整体不错但……”——这类话只在顶部说一次,不逐条重复;不要复述该行代码在做什么,因为审查者能读 diff;去掉“也许”“可能”“我认为”等模糊措辞,不确定就用 q:。
自动降级:安全类发现(CVE 级缺陷需完整说明与引用)、架构分歧(需要理由而非一行话)、新人上手场景(作者需要知道“为什么”)时,放弃精简模式,先写正常段落,之后再恢复精简。
限制与边界:仅用于审查,不写代码修复、不批准或请求更改、不运行 linter。输出可直接粘贴进 PR 的评论。说“stop caveman-review”或“normal mode”可恢复详细审查风格。其他功能、收费、价格与支持平台暂未提供。