用途:把代码评审评论写得简短、可执行,每条发现一行,包含位置、问题、修复。用于 PR 反馈,减少寒暄和重复描述。
主要能力:
- 单行格式:L<line>: <problem>. <fix>.;多文件 diff 用 <file>:L<line>: ...。
- 可选严重度前缀:🔴 bug(会引发故障的破损行为)、🟡 risk(可用但脆弱,如竞态、缺空值检查、吞异常)、🔵 nit(风格、命名、微优化,作者可忽略)、❓ q(真正的问题,不是建议)。
- 保留精确行号、反引号包裹的符号/函数/变量名、具体修复方案;当修复从问题描述不明显时补充原因。
使用方式:直接按上述格式输出可粘贴到 PR 的评论。去除“我注意到……”“似乎……”“你可能考虑……”等铺垫,以及“这只是一个建议”之类的措辞;开场表扬只说一次,不逐条重复;不重述该行代码的作用;避免模糊用词(perhaps、maybe、I think),不确定时用 q:。
自动清晰模式:安全类发现(CVE 级漏洞需完整解释与参考)、架构分歧(需要理由而非一行)、新人上手场景(作者需要知道“为什么”)时,暂停简短模式,改用正常段落,随后恢复简短。
限制:仅用于评审评论;不编写代码修复、不批准或请求变更、不运行 linter。“stop caveman-review”或“normal mode”可恢复冗长评审风格。其他细节暂未提供。