MemoryLake
返回全部文章
News2026 年 11 月 19 日·12 分钟阅读

现在 Claude Code 中的 /code-review 检查什么?为什么它仅报告 Bug 和 CLAUDE.md 违规项,Important、Pre-existing 和 Nit 的含义,以及何时该使用 /simplify 命令 (2026)

像往常一样,你在开启拉取请求(pull request)之前运行 /code-review。但今天的审查看起来变短了。关于重用现有辅助函数和整理长建议的提示消失了。剩下的是一个简短的列表,每项都贴上了你以前在终端没见过的标签,并且每项都以建议的修复方案结尾。其中一项发现指向了你的 CLAUDE.md 中被该更改违反的规则。

这就是新的行为。Claude Code 2026 年 11 月 19 日发布的 2.1.328 版本更新日志显示:“在大多数模型上更改了 /code-review,使其仅报告 Bug 和 CLAUDE.md 违规项;运行 /simplify 进行重用、简化和效率清理”。下一行补充了标签:“在大多数模型上更改了 /code-review,将每个发现标记为 Important、Pre-existing 或 Nit,并以建议的修复方案结束每个摘要”。

因此,本地审查已缩小到两类发现,其中一类直接来自你维护的指令文件。这使得你的 CLAUDE.md 对审查的重要性比昨天更高。

本指南涵盖了 /code-review 的变化、为什么文档仍描述旧的范围、三个标签的含义、本地审查读取哪些文件、何时应运行 /simplify、本地命令与托管的 Code Review 服务及 ultrareview 的区别,以及如何保持审查所依赖的规则处于最新状态。

2.1.328 版本有哪些变化

更新日志条目对本地命令进行了三项更改,均适用于大多数模型:

  • 范围。 审查现在“仅报告 Bug 和 CLAUDE.md 违规项”。
  • 标签。 每个发现都被标记为 Important、Pre-existing 或 Nit。
  • 输出。 每个摘要都以建议的修复方案结尾。如果没有可报告内容的审查现在会显示一行:Code review found no issues(代码审查未发现问题)。

“在大多数模型上”这一限定词在两行中都出现了。更新日志没有列出哪些模型被排除在外。如果更新后你的审查仍包含清理建议,那么你使用的模型可能是例外之一。

清理工作并未消失。它已移至一个单独的命令,更新日志指明了它:运行 /simplify 进行重用、简化和效率清理。

为什么文档仍描述旧的范围

在发布当天,本地审查页面仍以旧的描述开头:“Claude 审查你分支上的更改,查找正确性 Bug,并在对话中报告发现。根据你的模型和努力程度,审查还涵盖重用、简化和效率清理。”

命令参考中也有一行匹配的内容:“根据你的模型和努力程度,审查还涵盖清理机会。”

更新日志是更近期的来源。它也更具体,因为它指明了保留的两个类别。当发布说明和文档页面在同一天出现分歧时,稳妥的理解是页面尚未跟上进度。请使用 claude --version 检查你安装的版本,并将其与 2.1.328 进行比较。

更早的更新日志条目显示了这一功能的演变。一个版本曾将“中等努力程度下的审查更改为在未调整审查设置的模型(包括 Opus 5.5 和 Sonnet 5.5)上同时报告清理和 CLAUDE.md 规范发现”。/code-review 的范围在一段时间内一直随着模型和努力程度而变化。2.1.328 版本在大多数模型上缩小了这一范围。

Important、Pre-existing 和 Nit 的含义

更新日志列出了这三个标签,但没有为本地命令定义它们。GitHub 上的托管 Code Review 服务使用相同的三个标签,其文档定义如下:

  • Important: “应在合并前修复的 Bug”
  • Nit: “次要问题,值得修复但不阻塞合并”
  • Pre-existing: “代码库中已存在但并非由本次 PR 引入的 Bug”

Pre-existing 是最值得仔细阅读的一个。它是一个真实的 Bug,但不是由你的更改引起的。这对于决定范围非常有用:你可以现在修复它,或者记录下来单独处理,而不必将其视为你当前更改的阻塞因素。更新日志将这些标签描述为本地命令的一项更改,因此在此版本之前,你继承的 Bug 和你引入的 Bug 可能会并排出现在同一个列表中,而没有该标签。

Nit 涵盖次要问题。在托管服务上,团队可以通过仅限审查的文件重新校准哪些算作 Nit 或 Important。本地命令读取一组不同的文件,接下来将进行介绍。

本地审查读取哪些文件

这是更改与你的指令相连的地方。本地审查页面指出:“审查遵循你的 CLAUDE.md,包括在非交互式的 -p 运行中。它不读取 REVIEW.md。”

因此,对于你机器上的 /code-review 来说,CLAUDE.md 是文档记录的存放项目规则的地方。同一页面直接说明:“要为每个审查提供遵循的项目规则,请将它们添加到你的 CLAUDE.md 中。”

随着新范围的确定,这一点变得更加重要。CLAUDE.md 违规现在是大多数模型上审查报告的两件事之一。你仅保存在团队维基、拉取请求模板或脑海中的规范将不会被检查。

托管服务的自定义页面从另一个角度划定了界限:“该服务同时读取 CLAUDE.md 和 REVIEW.md。而你在自己机器上的 Claude Code 会话中运行的 /code-review 命令,读取你的 CLAUDE.md 文件,而不读取 REVIEW.md。”其建议是:“将你希望在两处都应用的指导放在 CLAUDE.md 中,并将 REVIEW.md 用于特定于拉取请求审查的规则。”

对于该服务,同一页面描述了 CLAUDE.md 的应用方式:“违反其中一条规则的更改将成为一个发现,其严重程度取决于问题的匹配程度。”它还提到服务会读取根文件以及每个更改文件父目录中的 CLAUDE.md 文件。

何时 /simplify 是正确的命令

/simplify 是清理工作的对应命令。命令参考这样描述它:“审查更改的代码以寻找清理机会并应用修复。”四个审查代理并行运行,涵盖现有辅助函数的重用、简化、效率以及更改是否处于正确的抽象层级。

同一条目明确界定了边界:“审查不查找正确性 Bug。使用 /code-review 来查找 Bug。”

命名历史可能会误导脚本。本地审查页面提到:“在 v2.1.147 之前,该命令名为 /simplify,当时它默认应用修复。如果你曾编写脚本使用 /simplify 来查找 Bug,请切换到 /code-review --fix。”

所以现在的划分很清晰:

  • /code-review 查找 Bug 和 CLAUDE.md 违规项,并进行报告。
  • /simplify 查找清理机会,并应用修复。

你可以按任意顺序运行它们。一个合理的习惯是先运行 /code-review,这样在清理工作重塑代码之前,正确性问题就已经得到了修复。

选择审查对象

本地页面指出,在没有目标的情况下,“/code-review 审查你分支中领先于其上游分支的提交以及你未提交的更改。”如果分支没有上游,它会与 main 或上一个提交进行比较。

你可以通过在努力程度和任何标志之后输入目标来指向其他位置。文档记录的目标包括拉取请求编号、一个分支与另一个分支的对比、提交范围以及文件或目录路径。当你希望将新范围应用于特定区域(例如其 CLAUDE.md 拥有自己规则的模块)时,路径非常有用。

要发布结果而不是在终端阅读,--comment 会“将发现作为内联评论发布在 GitHub 拉取请求上,或作为单条注释发布在 GitLab 合并请求上”。这些评论带有相同的标签,这使得 Pre-existing 标签在拉取请求线程中很容易被发现。

当 Claude 为你启动审查时

你并不总是需要自己输入命令。本地页面列出了 Claude 可以启动审查的两种方式。第一种是你用自然语言要求时:“要求 Claude 审查你的更改,它可以运行该技能”。第二种是会话范围内的计划任务,其提示词为 /code-review。

这两次运行使用的范围与输入的命令相同,因此计划审查现在也会报告 Bug 和 CLAUDE.md 违规项。如果你希望仅保留该命令供手动使用,该页面描述了设置文件中的 skillOverrides 条目,它可以使该技能仅由用户调用。这会阻止 Claude 和计划任务启动审查,同时保持命令对你可用。

更改或替换审查

/code-review 是一个内置技能。页面解释了这意味着什么:“它的指令内置在 Claude Code 中,因此磁盘上没有可供打开或编辑的 SKILL.md 文件。”

如果新范围不适合你的团队,你有文档记录的选项。页面指出,“名为 code-review 的项目或个人技能将代替内置技能运行,而 /review 别名将继续运行内置审查。”你也可以编写自己的审查子代理或审查技能。

在替换它之前,请考虑页面首先指出的更简单的路径:将规则放入 CLAUDE.md。内置审查已经遵循该文件,并且随着范围的缩小,那里明确的规则比长长的偏好列表更有可能作为发现浮现出来。

编写审查可以检查的规则

当规则具体时,CLAUDE.md 违规最容易被报告。例如,规定某个目录绝不能手动编辑、每个 API 路由都需要给定的中间件、或者测试不得触及生产数据库,这些都为审查提供了具体的对比依据。

模糊的偏好(如保持代码整洁)更接近 /simplify 处理的内容。将这些内容排除在 CLAUDE.md 之外也可以保持文件简短,这有助于 Claude 读取它的每一项任务,而不仅仅是审查。

本地审查如何运行

文档中的一些细节可以帮助你阅读结果。

它在后台运行。 “在终端会话中,审查作为具有自己上下文窗口的后台子代理运行,因此它不会填满你的对话。当审查完成时,发现会出现在你的对话中。”

除非你要求修复,否则它只报告。 页面指出,在没有 --fix 的情况下,“审查的指令仅要求 Claude 提供报告。”使用 --fix 时,编辑仍需通过你的权限模式。

后台修复后的回滚有限制。 页面提到,后台审查应用的 --fix 编辑发生在你的会话检查点之外,/rewind 仅恢复 Claude 已在对话中编辑过的文件。对于其余部分,其建议是使用 git。

努力程度改变覆盖范围。 “在 low 级别,审查报告它最有把握的发现,因此你会看到较少的误报。从 medium 到 max,审查会扩大覆盖范围。”当你没有输入级别时,审查会重用你上次输入的级别,即使是来自之前的会话。

桌面应用显示列表。 在要求结构化结果的宿主应用程序(如桌面应用)中,页面指出每个条目“显示文件位置、一句话摘要和类别标签”。修复也会被跟踪:“当 Claude 在会话后期修复报告的发现时,它会再次报告。Claude Code 随后会在更新的发现列表中将每个发现标记为已修复、已跳过或无需更改。”这个状态列表在工作时非常有用,并且只要会话存在就会一直保留。

发现数量有限制。 你可以使用 --max-findings 调高或调低它,在审查通过发现工具报告的地方,文档记录的限制是 32。

它与 Code Review 和 ultrareview 有何不同

三个审查工具共享一个名称,而新范围仅适用于其中之一。

  • /code-review 在你的会话中本地运行,读取 CLAUDE.md,现在在大多数模型上报告 Bug 和 CLAUDE.md 违规项。
  • Code Review 是托管服务,为你的组织审查 GitHub 上的拉取请求,并同时读取 CLAUDE.md 和 REVIEW.md。
  • Ultrareview 通过 /code-review ultra 启动,在云端运行更深层的审查。

本地页面指出 /review 是 /code-review 的别名,因此更改适用于这两个名称。

我们在 Claude Code 中的 ultrareview 指南中介绍了云端选项,包括它上传的内容以及发现结果返回的位置。

人们首先会尝试什么

在 /code-review 中寻找清理建议。 在大多数模型上,它们已移至 /simplify。

将本地审查的规则放在 REVIEW.md 中。 本地命令不读取它。请使用 CLAUDE.md。

将每个发现都视为阻塞。 在服务上,Nit 被定义为非阻塞,而 Pre-existing 被定义为并非由更改引入。

今天仍信任文档页面而非更新日志。 页面仍描述旧的范围。

使用 /simplify 来查找 Bug。 它不查找正确性 Bug。

修复方案:让 CLAUDE.md 承载你的审查规则

第 1 步:更新并检查你的版本

运行 claude --version。新范围在 2.1.328 版本中引入。

第 2 步:将审查相关的规则移入 CLAUDE.md

仅存在于维基或模板中的规范不在本地审查读取的文件中。

第 3 步:拆分你的审查习惯

运行 /code-review 查找 Bug 和规则违规,然后运行 /simplify 进行清理。

第 4 步:记录你决定推迟的 Pre-existing 发现

写下你留下了哪些、原因以及它们所在的位置。

在 MemoryLake 中设置

CLAUDE.md 是 Claude Code 读取项目规则的地方,保持其简短是高效使用它的一部分。有些上下文不属于那里:规则存在的原因、你选择推迟哪些 Pre-existing Bug、哪些区域不断产生相同的发现,以及你在审查后做出的决定。

MemoryLake 是此类项目上下文的记忆层,例如审查决策、推迟的问题以及规则背后的原因,它们被保存在一个由你维护的地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

你用自己的语言亲自编写条目。不会从你的 CLAUDE.md 文件、Claude Code 会话、审查发现、代码库或任何供应商的存储中读取、写入或删除任何内容。Claude Code 的审查工作方式正如 Anthropic 所描述的那样。

第 1 步:创建 API 密钥

登录并从控制面板生成密钥。像对待任何其他凭据一样,将其存储在代码库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供代理使用
MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供代理使用

第 2 步:上传你的第一批记忆

从你在修复方案第 4 步中写下的内容开始:推迟的发现及其原因。每个条目对应一个决策。

MemoryLake 工作区显示已上传的首批文档,列出了每个成为可搜索记忆的文件
MemoryLake 工作区显示已上传的首批文档,列出了每个成为可搜索记忆的文件

第 3 步:连接你的 AI 和代理

连接 Claude Code、Codex 以及你使用的其他助手。下一次审查或修复可以从相同的决策开始。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架

这在实践中改变了什么

第一个区别是重复发现减少了。推迟的 Pre-existing Bug 及其原因已被记录在案。

第二个是更精简的 CLAUDE.md。规则保留在那里,而背后的历史则存在于别处。

第三个是跨工具的一致性。相同的审查决策在 Claude Code 和其他助手中均可使用。

/code-review 的最佳实践

了解你的版本。 范围更改在 2.1.328 中引入。

将规则保留在 CLAUDE.md 中。 它是本地审查遵循的文件。

仅将 REVIEW.md 用于托管服务。 本地命令不读取它。

阅读标签。 Important 应在合并前修复,Nit 不阻塞合并,而 Pre-existing 并非由你的更改引入。

运行 /simplify 进行清理。 它应用修复且不查找 Bug。

有目的地选择努力程度。 Low 偏向于准确性,更高级别则扩大覆盖范围。

后台修复后使用 git。 Rewind 不会恢复后台审查编辑过的每个文件。

结论

2026 年 11 月 19 日发布的 Claude Code 2.1.328 在大多数模型上将 /code-review 缩小到 Bug 和 CLAUDE.md 违规项,将每个发现标记为 Important、Pre-existing 或 Nit,并以建议的修复方案结束每个摘要。清理工作移至 /simplify,该命令应用修复且不查找正确性 Bug。本地文档页面仍描述旧的范围,因此请根据更新日志检查你的版本。

本地审查遵循 CLAUDE.md,不读取托管服务使用的 REVIEW.md。随着新范围的确定,你的 CLAUDE.md 是审查检查的两件事之一,因此你希望在本地强制执行的规则应放在那里。将它们背后的原因和决策保存在比单次审查更持久的地方。

常见问题

现在 Claude Code 中的 /code-review 检查什么?

自 2.1.328 版本起,在大多数模型上仅检查 Bug 和 CLAUDE.md 违规项。

清理建议去哪了?

移至了 /simplify,它审查重用、简化和效率并应用修复。

Important、Pre-existing 和 Nit 是什么意思?

在托管服务上:分别指合并前需修复的 Bug、并非由本次更改引入的 Bug,以及不阻塞合并的次要问题。

/code-review 会读取 REVIEW.md 吗?

不会。它遵循你的 CLAUDE.md。REVIEW.md 用于配置托管的 Code Review 服务。

/simplify 会查找 Bug 吗?

不会。Anthropic 的参考说明指出应使用 /code-review 来查找 Bug。

/review 与 /code-review 有区别吗?

没有。/review 是 /code-review 的别名。

为什么文档中仍提到 /code-review 中的清理功能?

该页面仍描述旧的范围。2.1.328 的更新日志是更新的来源。